home *** CD-ROM | disk | FTP | other *** search
/ A.C.E. 3 / ACE CD 3.iso / files / utils / aplay200.lha / APlayer / Files / Docs.lha / APlayer.guide (.txt) next >
Amigaguide Document  |  1995-12-23  |  201KB  |  3,836 lines

  1. @database AccessiblePlayer.guide
  2. @Author Jail
  3. @INDEX INDEXNODE
  4. @Font topaz.font 8
  5. @Master APlayer.guide
  6. @Node Main "Root"
  7. @TITLE "AccessiblePlayer V2.00 Copyright 
  8.  Access 1994-1995"
  9.      Welcome to the Amigaguide
  10. d world of AccessiblePlayer:
  11.      Please select one of the following topics:
  12.      @{" Featurelist      " LINK Features} @{b}   List of cool features
  13.      @{" Disclaimer       " LINK Disclaimer}    Legal Information
  14.      @{" Registration     " LINK shareware}    How to register
  15.      @{" Requirements     " LINK Requirements}    What you need
  16.      @{" Introduction     " LINK Introduction}    Introduction to APlayer
  17.      @{" How to Install   " LINK Installation}    How to install APlayer
  18.      @{" ToolTypes/CLI    " LINK Tooltypes}    Tooltypes and CLI arguments
  19.      
  20.      @{" How to use       " LINK Usage}    How to use APlayer
  21.      @{" Keyboard control " LINK keyboard}    How to control APlayer with the keyboard
  22.      @{" Module Types     " LINK ModTypes}    Module types supported by APlayer
  23.      @{" ARexx            " LINK Arexxmain}    How to use ARexx with APlayer
  24.      
  25.      @{" Programmers      " LINK /Developer/Libraries.doc/MAIN}    Coders, read this
  26.      @{" Thanks to        " LINK Thanks}    I want to thank my producer, and mom & dad...
  27.      @{" History          " LINK History}    The history of APlayer
  28.      @{" Future           " LINK Future}    The future for APlayer ..
  29.      
  30.      @{" Contact          " LINK contact}    How to reach the author@{ub}
  31. @ENDNODE
  32. -------------------------------------------------------------------------------
  33. @NODE Features
  34. @TITLE "The Featurelist of AccessiblePlayer"
  35.   @{b}@{u}Special APlayer Features:@{ub}@{uu}
  36.  - Supports 64 different @{"module formats" LINK modtypes}.
  37.  - Supports S3M, Fasttracker I & II, Multitracker and more.
  38.  - Uses noteplayers. Stereo, 14 bit, surround, fastmem player ...
  39.  - Agent Interface
  40.  including, from v2.00, @{b}Graphical Scopes!@{ub}
  41.  - @{"Online Help" LINK OnlineHelp} (Press Help  while placing your pointer on the function you
  42.    want help for).
  43.  - @{b}WHY@{ub} requesters. If you get an error requester from APlayer and you don't
  44.    understand what's going on, press the WHY gadget in the requester.  This
  45.    gives  you  a  brief description of the error, and suggestions on how to
  46.    correct it.
  47.  - Recognizes  and  unpacks   179  different   cruncher  types  (using  the
  48.    @{"Unpack.library" LINK cfgunpack}).
  49.  - @{"Favourite Song System
  50. " LINK FSS}
  51.    @{b}No one else does this!!@{ub}
  52.  - @{"Play samples" LINK sampleinfo} by the keyboard while listening to the module.
  53.    This now includes a multikeyboard function (press "DEL").
  54.    The number of channels used depends of the module, so if you hear  a  16
  55.    channels S3M module you can play in multi mode with 16 CHANNELS!!!!
  56.    @{b}No one else does this!!@{ub}
  57.  - @{"Save samples" LINK sampleinfo} can be used to rip  your favourite  samples, even  if  you
  58.    don't own the actual music program. This also works with S3M, XM a.s.o.
  59.    @{b}No one else does this!!@{ub}
  60.  - Can play modules from Fast memory, saving your sparesome Chip memory.
  61.  - @{"App-Icon" LINK app-icon} and App-window.
  62.  - Full commodity interface. Depending on your @{"system" LINK Requirements}.
  63.  - Supports @{"Lha/Lzx files" LINK cfgunpack}, including extract pattern.
  64.  - Supports @{"Public Screens" LINK cfgwindowsscreens}.
  65.  - Make your own favourite lists of modules with the @{"APML
  66. " LINK ML} system.
  67.  - @{"Early load" LINK cfgOptions} system which kills the waiting time between the modules.
  68.    @{b}We were the first!!@{ub}
  69.  - @{"ARexx interface" LINK Arexxmain}
  70.  - And much, much more...
  71. @ENDNODE
  72. -------------------------------------------------------------------------------
  73. @NODE Future
  74. @TITLE "The Future of APlayer"
  75.   @{b}@{u}The Future of APlayer:@{ub}@{uu}
  76.   In this  text  we will try to give  you an idea of  what will  happen  to
  77.   APlayer in the coming versions.
  78.   - More Agents (any ideas? then write us NOW!)
  79.   - More scopes (Martin Wulffeld, Hvad mener du med at du ikke gider?)
  80.   - Automatic conversion of protracker clones
  81.   - Automatic ripping of modules from  all kinds of files (e.g. from a demo
  82.     executable file).
  83.   - Even more players
  84.   - Your ideas ;-)
  85.   - And more, more, more ....
  86. @ENDNODE
  87. -------------------------------------------------------------------------------
  88. @NODE Disclaimer
  89. @TITLE "Copyright information and rules of distribution"
  90.   @{b}@{u}Copyright information:@{ub}@{uu}
  91.   AccessiblePlayer is now @{"Shareware" LINK Shareware}.  However  parts  of  the  APlayer  is
  92.   copyright by  other people  (the external players). Whereever possible we
  93.   have tried to make sure  that  no  parts  of  the  APlayer  violates  any
  94.   copyrights.  If  you  think  this  is  not  the  case,  please contact us
  95.   immediately!
  96.   If you or your company  want to use APlayer on  a coverdisk  or something
  97.   like that, we would like to know about it, and get a copy of the product.
  98.   And  since  RBF  Software  wants us  to do this, we must  write that  the
  99.   OctaMED and MED players are copyrighted by them.
  100.   @{b}Although this program is SW, you  are  welcome  to  send  anything,  like
  101.   money, ski masks,  postcards,  cars,  burgers  (preferably McChicken!?!),
  102.   Kinder M
  103. lkesnitte etc.@{ub}
  104. @ENDNODE
  105. -------------------------------------------------------------------------------
  106. @NODE Shareware
  107. @TITLE "Shareware Notice"
  108.   @{b}@{u}Shareware Payment:@{ub}@{uu}
  109.   Everything has a price .. even APlayer :) :(
  110.   Until now APlayer has been a free-to-use program for all of you. But  due
  111.   to  the fact that APlayer now requires a lot of work from the programmer,
  112.   we have decided to make APlayer shareware. If you do  not  register  your
  113.   copy  of  APlayer, there will be a few things to annoy you :) The program
  114.   is still usable, there aren't  any F*CK*NG requesters every time  you  do
  115.   something. Only a few useful things have been disabled:
  116.   - No ARexx support
  117.   - No Rewind/Fast forward
  118.   - A limited number of modules in the list at a time.
  119.   If you register, you will also get your name in the about window :)
  120.   @{b}IMPORTANT:@{ub}
  121.   If you register, you will only register the MAIN program. All the players
  122.   and  noteplayers  are  still  public domain. We can't make money on other
  123.   peoples work :)
  124.   @{b}How To Register:@{ub}
  125.   @{i}No matter how you register, you will have to fill  out  the  registration
  126.   form and send it to us together with your registration.@{ui}
  127.   1. Cash Registration
  128.      You can send cash directly to the author in two different currencies:
  129.      100 Dkr (Danish Kroner)
  130.      25 US Dollars (Due to the exchange price)
  131.      Send them to:
  132.      @{b}Thomas Neumann
  133.      Kongensgade 78
  134.      3550 Slangerup
  135.      Denmark@{ub}
  136.   2. Eurocheck
  137.      If you live in europe you can just use an eurocheck or another type of
  138.      check which will not cost us anything to cash. The amount is:
  139.      100 Dkr (Danish kroner)  eq. to 10 UK Pound or 25 DM
  140.      If your bank won't write the check in  Dkr,  then  you  should  add  5
  141.      pounds (12 DM) extra for the exchange fee.
  142.      Send them to: See above
  143.   3. NET registration (Idea taken from the GoldED package)
  144.      This is the easiest way to register. You can  send  an  email  to  the
  145.      email  address  below.  Then  you  can deposit the money direct on the
  146.      author's account (this can be done in any bank).
  147.      You will then recieve an E-mail with an UUencoded keyfile.
  148.      Send the letter to:
  149.      jail@diku.dk
  150.      and transfer the money (100 Dkr) to this account within two weeks (you
  151.      will not get the keyfile before we recieve the money):
  152.      @{b}Thomas Neumann
  153.      Account number: 5822 0003091623
  154.      Unibank
  155.      Frederiksborgvej 9
  156.      3650 
  157. lstykke
  158.      Denmark@{ub}
  159. @ENDNODE
  160. -------------------------------------------------------------------------------
  161. @NODE Requirements
  162. @TITLE "Hard'n'soft-ware requirements"
  163.   @{b}@{u}Hard'n'soft-ware requirements:@{ub}@{uu}
  164.   You need at least kickstart v2.04 to use this program.
  165.   Four  general libraries  are  necessary  to  run  the  APlayer  with  all
  166.   functions.  APlayer  cannot  start  without  the  Reqtools.library (v38+)
  167.   (included)   and   any  version  of  the  Diskfont.library.  But  if  the
  168.   commodities.library  isn't  available,  it  will  just  not  start  as  a
  169.   commodity (this means that you can't use the hotkeys). Amigaguide.library
  170.   is needed if you want online help for APlayer.
  171.   If you want the APlayer to unpack your modules, you should use one of the
  172.   following   libraries:   Powerpacker.library,  Xpkmaster.library  or  the
  173.   Unpack.library. All of them are included in this package though.
  174.   To make use of the ARexx part of APlayer you need  the  Rexxtools.library
  175.   which is included in the package.
  176.   The APlayer has been successfully tested on the following machines:
  177.   Plain A1200, A1200+4MB fastram, A1200+68030+4MB Fastram,  A4000(680EC30)+
  178.   16MB  Fastram,A4000(68040)+16MB  Fastram and an A4000(68060)+16MB Fastram
  179.   including tests with Enforcer, Mungwall and IOtorture.
  180. @ENDNODE
  181. -------------------------------------------------------------------------------
  182. @NODE Introduction
  183. @TITLE "Introduction to AccessiblePlayer"
  184.   @{b}@{u}Introduction:@{ub}@{uu}
  185.   The AccessiblePlayer is our contribution to the  Amiga  market  of  music
  186.   players.  We  thought  that  our favourite player (Smartplay) just wasn't
  187.   good enough anymore, and since none  of  the  available  players  (D.A.S.
  188.   Modplayer,  Delitracker,  HippoPlayer,  BananaPlayer, EagleTracker and so
  189.   on) fulfilled our needs, we decided to write our own player.
  190.   We hope we have reached our goal by making a small, fast and userfriendly
  191.   player, the AccessiblePlayer.
  192.   @{b}P.S. Some people think that we are the guys behind Smartplay. That is @{i}NOT@{ui}
  193.   true. We have never been in contact with  the maker  of Smartplay and  we
  194.   probably never will.@{ub}
  195. @ENDNODE
  196. -------------------------------------------------------------------------------
  197. @NODE Installation
  198. @TITLE "Installing the AccessiblePlayer"
  199.   @{b}@{u}Installation:@{ub}@{uu}
  200.   Just  use  the  installer-script  included  in this package. You can both
  201.   install AND remove (who would?) the APlayer with that script.
  202.   @{b}Warning:@{ub} APlayer is pretty complex to  install, so if you want to install
  203.            it by hand, don't blame us if something goes wrong.
  204.            In other words: @{i}"Don't try this at home"@{ui}
  205. @ENDNODE
  206. -------------------------------------------------------------------------------
  207. @{ub}
  208. @NODE Usage
  209. @TITLE "How to use AccessiblePlayer"
  210.   @{b}@{u}The Accessible Interface:@{ub}@{uu}
  211.    -----------------------------------------------------------------------
  212.    | 
  213.  |  AccessiblePlayer 2.00                          @{"(1/1)" LINK tunes}          |
  214.    |----------------------------------------------------------------------
  215.    |@{" Cycle gadget  " LINK MainCyc}@{"                 Status bar                 " LINK Status}@{" S " LINK Sampleinfo}@{" ? " LINK About}|
  216.    |----------------------------------------------------------------------
  217.    |@{"_
  218. " LINK Volreset}@{" Volume Slider " LINK Volume}|                                           |    |
  219.    |--------------------|                                           |    |
  220.    |@{" 
  221. >" LINK SReset}@{"  Speed Slider " LINK Speed}|            @{" Main Listview " LINK mainListview}               |@{" | " LINK scroll}|
  222.    |--------------------|                                           |    |
  223.    |@{" 1 2 3 4 " LINK 1}@{" [] " LINK Loop}@{"^v^v" LINK Shuffle}|                                           |    |
  224.    |----------------------------------------------------------------------
  225.    |@{" ICN" LINK Icn}@{" CFG" LINK Cfg}@{" FSS" LINK FSS}@{" ML " LINK ML}@{"  |<  " LINK Prev}@{"  <<  " LINK Rew}@{"   >  " LINK Play}@{"  >>  " LINK FF}@{"  >|  " LINK Next}@{"   ^  " LINK Eject}@{"  ||  " LINK Pause}|
  226.    -----------------------------------------------------------------------
  227.   @{b}App-Window@{ub}: The   main  window  of  APlayer  can  be  used  for  dropping
  228.               module-icons.  The names of the modules will automatically be
  229.               added  to  the  end  of the modulelist. See also @{"App-Icon" LINK App-icon}.
  230.   @{b}The Zoom Gadget@{ub} can be used to zip the program window.  The  main  window
  231.   will  be  zipped  to the titlebar only. Notice that the placement will be
  232.   saved in the configuration file.
  233. @ENDNODE
  234. -------------------------------------------------------------------------------
  235. @Node Maincyc
  236. @TITLE "Main window cycle"
  237.   @{u}@{b}Main window cycle:@{ub}@{uu}
  238.   This cyclegadget is used to select the state of the @{"status-bar" LINK status}.
  239.   There are five different states of this cycle, which are:
  240.   @{b} Name   : @{ub}
  241.     This shows the name of the module, which is found IN the module. e.g it
  242.     is  not  necessarily  the  name  of  the  file, so the two names can be
  243.     different; that is, if the player can't find a name inside the  module,
  244.     the filename will be displayed in the @{"status bar" LINK Status}.
  245.   @{b} Author : @{ub}
  246.     The player tries to find the name of the author in the module,  and  if
  247.     it  succeeds, it  will display it in the statusline. See in the section
  248.     @{"Module types" LINK modtypes} for info on which players  support the  author  name.
  249.   @{b} Played : @{ub}
  250.     This  shows,  if supported (see @{"Module types" LINK modtypes}), the actual position and
  251.     the  total  songlength.  It  also  calculates  how many % of the module
  252.     that has been played, and the total listening time.
  253.   @{b} Type   :@{ub}
  254.     When  the  module has been tested, the @{"module type" LINK modtypes} is displayed in the
  255.     status-line.  This  could be anything from the SID-player to the TFMX 7
  256.     channel replayer.
  257.   @{b} RexxMsg:@{ub}
  258.     This displays info text made by an @{"Arexx" LINK ARMAINCYCLE} script.
  259. @ENDNODE
  260. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  261. @Node Status
  262. @TITLE "Status bar"
  263.   @{u}@{b}Status Bar:@{ub}@{uu}
  264.   This  line will display some info on the current module.  It will display
  265.   the name, author, playing time, module type and rexx message.
  266.   See @{"Main window cycle" LINK mainCyc} on how to change the state.
  267. @ENDNODE
  268. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  269. @Node SampleInfo
  270.   @{u}@{b}Sample info window:@{ub}@{uu} (Shortkey s)
  271.   Pressing  the @{b}S@{ub}-Button will, if samples are supported (see @{"module types" LINK modtypes})
  272.   open a new  window called the sampleinfo  window. The samples are  always
  273.   saved in signed IFF-8SVX format.
  274.   From left to right it will display the number of the sample,  name,  size
  275.   in  bytes,  type  of  the  sample  and  whether  it's  placed in chip- or
  276.   fast-memory.
  277.   The sample can be of these different types:
  278.   XX - it means that it's a sample with the sample bit XX.
  279.   AM - Synthetic voices (Amplitude Modulation)
  280.   FM - Precalculated synthetic voices (Frequency Modulation)
  281.   HB - Sample used as a synthetic voice (HyBrid)
  282.   AL - AdLib sound used in S3M modules
  283.   WS - WaveSample. Same as hybrid samples, but these  can be played in  the
  284.        sample window. Used in Art of Noise.
  285.   ?? - Unknown type
  286.   -- - No sample
  287.   If the type is typed in @{b}bold@{ub} it means that the sample is unsigned.
  288.   The sampleinfo window is not only a display/info window, you can actually
  289.   use it to accompany your favourite modules. You can do it in two ways:
  290.   @{b}1@{ub}. Pause  the  module  (in  the  main  window) and use your mouse, or the
  291.      @{"keypad" LINK Keypad},  to  select a sample. Then you can use your keyboard (like in
  292.      Protracker) to play the sample at different notes, ranging from C-1 to
  293.      B-3.  Like  in  protracker you can use F1 and F2 to change whether the
  294.      z-key  should  be a C-1 (default) or a C-2 note. Note that if a sample
  295.      has the volume set to 0, then it will be played with a value of 64.
  296.   @{b}2@{ub}. Turn off one  of the @{"sound-channels" LINK 1} and, like before, choose a sample
  297.      with the @{"keypad" LINK Keypad} or with the mouse. Then use the keyboard to accompany
  298.      the module.
  299.   @{b}Multichannel Mode:@{ub}
  300.      Per default  APlayer will only play  the sample in one channel. But if
  301.      you   press  "DEL"   (the  Delete  key)   in  the  sampleinfo  window,
  302.      multichannel mode will be enabled.
  303.      If you are in pause mode, all the channels  which are ON will be used.
  304.      If  you are  using the  accompany  function, the  OFF  turned channels
  305.      will be used to play the samples.
  306.      Please note that the number of channels used is  dependant of the used
  307.      Player.
  308.   The last function in the sampleinfo window is the little  disk-gadget  in
  309.   the upper right corner of the window. Selecting a sample and pressing the
  310.   disk-gadget will open a requester which will let you save the  sample  as
  311.   an  8SVX  soundfile with the samplerate 16574 (in pal) or 16726 (in ntsc)
  312.   which is the C-3 note. Pressing "return" will do the same.
  313.   If you have the @{"Multi Sample Saver Agent" LINK multi} present in  your agent list, it
  314.   will pop up to give you much more options on how to save the sample
  315.   Instead of using the keypad or the mouse, you can use the @{"keyboard" LINK listview}.
  316.   If you want to stop the playing sample NOW! then  you  can  hit  the  "<"
  317.   which is placed on the right side of the left shift key.
  318.   @{b}NOTE: Not  all players support  the sample info window, and therefore not
  319.         the  sample-save  and  accompany  functions. (see @{"Module types" LINK modtypes} for
  320.         more info)@{ub}
  321. @ENDNODE
  322. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  323. @Node Keypad
  324.   @{u}@{b}Numeric Keypad:@{ub}@{uu}
  325.   This  works  exactly  like in @{"QuadraComposer" LINK Thanks}. Sample 1-16 is chosen from
  326.   the  upper  left corner on the numpad to the lower right corner, which is
  327.   the Enter-key. @{b}"0"@{ub} is used to jump forward 16 samples, and @{b}"."@{ub} to go back
  328.   to the previous 16 samples.
  329.   Note that pressing a keypad key, will trigger the sample at the note C-3.
  330.   And that is not changeable yet, sorry!
  331.   Note that if a sample has the volume set to 0, then  it  will  be  played
  332.   with a value of 64.
  333. @ENDNODE
  334. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  335. @Node About
  336.   @{u}@{b}About Window:@{ub}@{uu} (Shortkey ?)
  337.   This will open a window containing some info on the current module:
  338.     @{b}Module name           :@{ub} The name of the module.
  339.     @{b}Author                :@{ub} The author of the module.
  340.     @{b}Active Player         :@{ub} The Player-library which is used now.
  341.     @{b}Active NotePlayer     :@{ub} The actual NotePlayer.
  342.     @{b}Number of tunes       :@{ub} Number of @{"tunes" LINK tunes} in the module.
  343.     @{b}Song Length           :@{ub} How long is this module, songpositions.
  344.     @{b}Used Patterns         :@{ub} How many different patterns are used.
  345.     @{b}Supported/Used samples:@{ub} The  number of used or supported samples e.g. a
  346.                             Protracker  module  will always use 31 samples,
  347.                             while  a  QComposer  uses  a  various number of
  348.                             samples.
  349.     @{b}Used Channels         :@{ub} The number of channels in the actual module.
  350.     @{b}Used Mixing rate      :@{ub} This  will, if a NotePlayer  is mixing, display
  351.                             the actual mixing rate.
  352.     @{b}Actual Speed          :@{ub} This  is  only  useful  for  players supporting
  353.                             cia-speed commands (like Protracker).
  354.     @{b}Module Size           :@{ub} The size of the unpacked module.
  355.   @{b}NOTE: A lot of the above-mentioned parameters is not supported by all the
  356.         players.  See  @{"module types" LINK modtypes}  for  info on which players supporting
  357.         what, or try it out for yourself.@{ub}
  358.   The "next"-gadget will show you the version number, the  arexx-port  name
  359.   and the creditlist for the AccessiblePlayer.
  360.   You can use the "cancel"-gadget or <return> to go back to the main window
  361.   again.
  362. @ENDNODE
  363. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  364. @Node tunes
  365.   @{u}@{b}Tunes:@{ub}@{uu}
  366.   A module normally consists of 1 tune only, but players like SID and  TFMX
  367.   supports  more  tunes in one module. You can choose between the different
  368.   tunes using  the keys 1-9 and 0 for  10. Of course,  you can also use the
  369.   numeric keyboard. If there  are more than  10 tunes, you  may use "+" and
  370.   "-" to skip to the  next 10 tunes or to go back to the previous 10 tunes.
  371.   The only place where you can't do it is in the sample info window.
  372.   The "(x/y)" in the title bar shows "current tune/total number of tunes".
  373.   If you zip the window, this will instead show the position/length.
  374. @ENDNODE
  375. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  376. @Node Volreset
  377. @TITLE "Volume Reset"
  378.   @{u}@{b}Volume Reset:@{ub}@{uu}
  379.   Pressing  this  gadget will reset the volume to the default volume, saved
  380.   in your config-file (see @{"configuration" LINK cfg}). You can also use @{"keyboard" LINK keyboard}.
  381. @ENDNODE
  382. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  383. @Node Volume
  384. @TITLE "Adjust Volume"
  385.   @{u}@{b}Volume Adjusting:@{ub}@{uu}
  386.   This slider is used to boost or lower the volume of the player.  Remember
  387.   that the actual volume is saved with your configuration file!
  388.   You can also use @{"keyboard" LINK keyboard}.
  389.   See also @{"Volume reset" LINK volreset} and @{"Configuration" LINK cfg}
  390.   @{b}NOTE: Nearly all moduleplayers support this, but a few don't. See in the
  391.         @{"Module types" LINK modtypes} section for more info.@{ub}
  392. @ENDNODE
  393. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  394. @Node MainListview
  395. @TITLE "Main window list"
  396.   @{u}@{b}Main window module list:@{uu}@{ub}
  397.   This  displays  all  the  modules  currently  in the @{"module list" LINK modlist}. If you
  398.   choose  a  module  it will be highlighted. That is, the playing module is
  399.   always the one which is highlighted.
  400. @ENDNODE
  401. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  402. @Node Scroll
  403. @TITLE "Modulelist Scroller"
  404.   @{u}@{b}Modulelist Scroller:@{ub}@{uu}
  405.   Use this scrollbar to scroll through the @{"list of modules" LINK mainlistview}.
  406. @ENDNODE
  407. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  408. @Node Sreset
  409. @TITLE "Speed Reset"
  410.   @{u}@{b}Speed Reset:@{ub}@{uu}
  411.   Pressing  this gadget will reset the speed to the default value, saved in
  412.   your config-file. (See @{"configuration" LINK cfg}).
  413.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  414.   @{b}NOTE: Changing  of  speed  is  only  available  when  the player supports
  415.         cia-timing. (See @{"Module types" LINK modtypes})@{ub}
  416. @ENDNODE
  417. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  418. @Node Speed
  419. @TITLE "Adjust Speed"
  420.   @{u}@{b}Adjusting Speed :@{ub}@{uu}
  421.   This slider is used for changing the speed of the module.
  422.   Remember that the default speed is saved with your configuration file!
  423.   (See @{"Configuration" LINK cfg})
  424.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  425.   @{b}NOTE: Changing  of  speed  is  only  available  when  the player supports
  426.         cia-timing. (See @{"Module types" LINK modtypes})@{ub}
  427.   See also @{"Speed reset" LINK Sreset}.
  428. @ENDNODE
  429. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  430. @Node 1
  431. @TITLE "Sound Channels"
  432.   @{u}@{b}Sound Channels:@{ub}@{uu}
  433.   These 4 buttons are used to turn the amiga sound channels on or off. This
  434.   is used when you want to accompany the module.
  435.   (See the @{"Sampleinfo window" LINK sampleinfo}).
  436.   Please notice that these buttons indicate the  hardware  audio  channels,
  437.   which  means  that  if  a  noteplayer  is playing, pressing the channel 1
  438.   button can turn of upto 8 channels.
  439.   Ofcourse they can be used for fun too!
  440.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  441.   @{b}NOTE: It's  not  all moduletypes which supports turning off channels e.g.
  442.         the 7 channel TFMX-player. See the @{"Module type section" LINK modtypes}.@{ub}
  443. @ENDNODE
  444. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  445. @Node Loop
  446. @TITLE "Loop Active Module"
  447.   @{u}@{b}Module Loop:@{ub}@{uu}
  448.   This gadget can toggle between positions:
  449.   - No  looping,  which  will automatically skip to the next module, when a
  450.     module is finished.
  451.   - Looping,  which  will make the actual module start over again when it's
  452.     finished.
  453.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  454.   @{b}NOTE: This  function  is  only  supported  by  some  moduletypes. See the
  455.         @{"Moduletype section" LINK modtypes} for info. @{ub}
  456. @ENDNODE
  457. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  458. @Node Shuffle
  459. @TITLE "Shuffle Modulelist"
  460.   @{u}@{b}Modulelist Shuffler:@{ub}@{uu}
  461.   Pressing this gadget will shuffle all the modules in the list, making the
  462.   actual module the first. If no modules are played the first module in the
  463.   shuffled list will be loaded and played.
  464.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  465.   Of  course  this  function  only have a meaning when you have more than 2
  466.   modules in the list.
  467. @ENDNODE
  468. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  469. @Node Icn
  470. @TITLE "Iconify AccessiblePlayer"
  471.   @{u}@{b}Iconifying AccessiblePlayer:@{ub}@{uu} (Shortkey i)
  472.   This will close all the open windows belonging to the APlayer, and pop up
  473.   an  @{"APP-ICON" LINK App-icon}. If you want to open the Player again you just double-click
  474.   the   app-icon.  Or  you  can  use  the  popup-hotkey  specified  in  the
  475.   @{"configuration-window" LINK cfg}.
  476. @ENDNODE
  477. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  478. @Node App-icon
  479. @TITLE "App-Icon"
  480.   @{u}@{b}AccessiblePlayer App-icon:@{ub}@{uu}
  481.   When the APlayer is iconified you can drop module-icons on  the app-icon.
  482.   This is done by opening the drawer in which you are keeping your modules,
  483.   select one (or more, using shift), then move the pointer over the APlayer
  484.   app-icon  and  release the mousebutton. The modules will automatically be
  485.   appended to your actual modulelist, and if it's empty,  the  player  will
  486.   play the first of the dropped modules.
  487. @ENDNODE
  488. ---------------------------------------------------------------------------
  489. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  490. ---------------------------------------------------------------------------
  491. @Node ML
  492. @TITLE "Module list Editor"
  493.   @{u}@{b}Module list Editor:@{uu}@{ub} (Shortkey m)
  494.   This editor is used to create/change/load and save @{"modulelists" LINK modlist}.
  495.   @{b}Add:@{ub}    Opens  a  filerequester from which you can choose the modules you
  496.           want to add to the module list. The selected modules will  either
  497.           be added in the end of the list or, if you have selected a module
  498.           in the modulelist, just before that.
  499.   @{b}Del:@{ub}    Deletes the selected module from the list.
  500.           Pressing shift together with  the  del  button  will  delete  all
  501.           double instances of a module/file in the list.
  502.   @{b}Exg:@{ub}    Select  a  module,  press  exchange and pick a module to exchange
  503.           with the first.
  504.   @{b}Clear:@{ub}  Clears the module list completely.
  505.   @{b}Sort:@{ub}   Sorts the module list alphabetically.
  506.   @{b}Load:@{ub}   Opens  a  filerequester  which  lets  you open a new module list,
  507.           deleting the current one.
  508.   @{b}Append:@{ub} Exactly  the  same as above, but this will append the chosen list
  509.           at the end of the list, or just before the selected module.
  510.   @{b}Save:@{ub}   Opens  a  filerequester  which  lets  you save the current module
  511.           list, with an ".APML"- extension.
  512.   @{b}Arrow up/down:@{ub} These will move the marked module to  either  the position
  513.                  above or below.
  514.                  Pressing @{b}shift@{ub} in  conjunction  with the gadget, will move
  515.                  the selected module to the top or the bottom of the list.
  516.   The number of modules in the list can always be seen in the right side of
  517.   the window titlebar.
  518.   To move around in the list you can use the @{"keyboard" LINK listview}.
  519.   To highlight the module being played press control+return.
  520.   @{b}NOTE:@{ub} A  nice  feature  is  that if you doubleclick an item in the module
  521.         list, in the module list editor, the module will  be  loaded.  This
  522.         can give you a better view of how the list looks.
  523. @ENDNODE
  524. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  525. @NODE modlist
  526. @TITLE "Module list"
  527.   @{u}@{b}Module list:@{uu}@{ub}
  528.   The module list is the name for the modules displayed in the
  529.   @{"main window module list" LINK mainlistview}.
  530. @ENDNODE
  531. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  532. @Node Prev
  533. @TITLE "Previous module"
  534.   @{u}@{b}Previous module:@{uu}@{ub}
  535.   Pressing this button will tell APlayer to  restart  the  current  module,
  536.   except  if  the  current module is still playing the first pattern
  537. , then
  538.   APlayer will skip to the previous module in the list.
  539.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  540. @{b}NOTE: This function is only supported by some moduletypes.
  541.          See the @{"Moduletype section" LINK modtypes} for info. @{ub}
  542. @ENDNODE
  543. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  544. @Node Rew
  545. @TITLE "Rewind"
  546.   @{u}@{b}Rewind:@{uu}@{ub}
  547.   This will skip to the previous pattern in  the  current  module.  If  you
  548.   press rewind when the first pattern is playing, it will just restart.
  549.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  550.   @{b}NOTE: This function is only supported by some moduletypes.
  551.         See the @{"Moduletype section" LINK modtypes} for info. @{ub}
  552. @ENDNODE
  553. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  554. @Node Play
  555.   @{u}@{b}Play:@{uu}@{ub}
  556.   This opens a filerequester which lets you add one or more modules to  the
  557.   current  list  of  modules.  This will only disable the pause mode if you
  558.   have the @{"Jump To Loaded Module" LINK Jumtoaddedmodulepload} gadget in the configuration checked.
  559.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  560. @ENDNODE
  561. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  562. @Node FF
  563. @TITLE "Fast Forward"
  564.   @{u}@{b}Fast Forward:@{uu}@{ub}
  565.   Use this to skip to the  next pattern.  If you reach the end it will load
  566.   and play the next module.
  567.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  568.   @{b}NOTE: This function is only supported by some moduletypes.
  569.         See the @{"Moduletype section" LINK modtypes} for info. @{ub}
  570. @ENDNODE
  571. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  572. @Node Next
  573. @TITLE "Next module"
  574.   @{u}@{b}Next Module:@{uu}@{ub}
  575.   Pressing  this will tell APlayer to  skip to the next module in the list.
  576.   If  you  are  in  @{"pause" LINK pause} mode  APlayer will  unpause and skip to the next
  577.   module.
  578.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  579. @ENDNODE
  580. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  581. @Node Eject
  582. @TITLE "Eject module"
  583.   @{u}@{b}Eject:@{uu}@{ub}
  584.   Pressing this once will stop the current  module  and  free  the  memory.
  585.   Pressing it again clears the module list.
  586.   If you hold down the shift key while  pressing  the  eject  button,  will
  587.   eject all other modules than the one currently playing.
  588.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  589. @ENDNODE
  590. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  591. @Node Pause
  592. @TITLE "Pause module"
  593.   @{u}@{b}Pause:@{uu}@{ub}
  594.   This will simply pause the module playing right  now.  And  play  if  you
  595.   press it again.
  596.   You can also use @{"keyboard" LINK keyboard} to control this feature.
  597. @ENDNODE
  598. -------------------------------------------------------------------------------
  599. @NODE keyboard
  600. @TITLE "Keyboard control keys"
  601.   @{b}These keys can be used in all windows when they are activated:@{ub}
  602.   --------------------------------------------------------------
  603.   @{b}Space              @{ub}: Can be used to  toggle  the  state  of  the
  604.                        audio  filter. However, if you have checked
  605.                        the  @{"Force Filter Off" LINK cfgoptions}   gadget   in   the
  606.                        configuration window, space will not affect
  607.                        anything.
  608.   @{b}TAB                @{ub}: Cycles through the APlayer windows.
  609.   @{b}Escape             @{ub}: Use this to close the  active  window.  All
  610.                        APlayer  windows  can be closed, except for
  611.                        the main window. If you press escape in the
  612.                        main window,  one of the other windows will
  613.                        close for each keypress.
  614.   @{b}These keys can only be used when the main window is activated:@{ub}
  615.   --------------------------------------------------------------
  616.   @{b}`  Back apostrophe @{ub}: Jump to random module and play it
  617.   @{b}~  Tilt            @{ub}: Shuffle
  618.   @{b}Del                @{ub}: Eject
  619.   @{b}Shift Return       @{ub}: Reset volume
  620.   @{b}Alt Return         @{ub}: Reset Speed
  621.   @{b}Arrow up           @{ub}: Like pressing the play button
  622.   @{b}Arrow down         @{ub}: Pause
  623.   @{b}Arrow left         @{ub}: Rewind
  624.   @{b}Arrow right        @{ub}: Forward
  625.   @{b}Shift Arrow left   @{ub}: Loads next module
  626.   @{b}Shift Arrow right  @{ub}: Loads previous module
  627.   @{b}Alt Arrow up       @{ub}: Increase speed
  628.   @{b}Alt Arrow down     @{ub}: Decrease speed
  629.   @{b}Alt Arrow left     @{ub}: Increase volume
  630.   @{b}Alt Arrow right    @{ub}: Decrease volume
  631.   @{b}[ or (             @{ub}: Toggle channel 1    \
  632.                                             |
  633.   @{b}] or )             @{ub}: Toggle channel 2     |
  634.                                              
  635.  Top row on numpad
  636.   @{b}/                  @{ub}: Toggle channel 3     |
  637.                                             |
  638.   @{b}*                  @{ub}: Toggle channel 4    /
  639.   @{b}Backspace          @{ub}: Module loop on/off
  640.   @{b}<                  @{ub}: Cycle the maincycle gadget backwards
  641.   @{b}>                  @{ub}: Cycle the maincycle gadget forwards
  642.   For  control  keys  in  the special  windows,  see the  sections  on  the
  643.   different windows.
  644. @ENDNODE
  645. --------------------------------------------------------------------------------
  646. @NODE Tooltypes
  647. @TITLE "Tooltypes and CLI arguments.."
  648.   @{u}@{b}Tooltypes and CLI arguments:@{uu}@{ub}
  649.   (Lines in @{i}italic@{ui} explains what will  happen  when APlayer is started with
  650.   the argument/tooltype and APlayer is running already.
  651.   @{b}CX_POPUP (POP):@{ub} Defines if you want the APlayer to  open  its  window  at
  652.   startup, or start in hidden mode.
  653.   Keywords are @{b}YES@{ub} (default) or @{b}NO@{ub}.
  654.   @{b}CX_POPKEY (KEY):@{ub} The hotkey for APlayer. All valid commodity hotkeys will
  655.   work here. Default is "ctrl alt a".
  656.   @{b}CX_PRIORITY (PRI):@{ub} The APlayer task priority. Default is 0.
  657.   @{b}MODULE:@{ub} This argument is CLI ONLY! Just type the name (with path) of  the
  658.   module(s) and it will be placed in the modulelist. APlayer will not start
  659.   to play the first module, unless you also use the JUMP argument!
  660.   @{i}The modules will be added to the list.@{ui}
  661.   @{b}MODULELIST (ML):@{ub} The name of a modulelist file you want APlayer  to  use.
  662.   For instance S:example.APML. The modules in the modulelist will be placed
  663.   before any modules specified on the Command line.
  664.   @{i}The modules in the modulelist will be added to the list.@{ui}
  665.   @{b}CONFIGFILE (CFG):@{ub} Specifies the config file you want to use.  Default  is
  666.   ENV:APlayer/APlayer.prefs
  667.   @{b}PUBSCREEN (PS):@{ub} The  public  screen  on  which  you want APlayer to open.
  668.   Remember that  the  name is case SenSitiVe. Default is the default public
  669.   screen, e.g. Workbench.
  670.   @{i}APlayer  will  close all  the APlayer  windows  and  reopen  them  on the
  671.   specified public screen.@{ui}
  672.   @{b}LOOP:@{ub} Specifies the state of the loop gadget in the main window  (ON/OFF)
  673.   or toggles the state (as set in your configuration) (TOGGLE).
  674.   @{i}Same effect.@{ui}
  675.   @{b}INFOOPEN (IO):@{ub} This will force the info window to open at start.
  676.   @{i}Same effect.@{ui}
  677.   @{b}MODULELISTOPEN (MO):@{ub} If  you  want  the  module  list  window to  open at
  678.   startup, use this argument.
  679.   @{i}Same effect.@{ui}
  680.   @{b}FSSOPEN (FO):@{ub} Use this argument if you want the FSS window to  be  opened
  681.   at startup.
  682.   @{i}Same effect.@{ui}
  683.   @{b}SHUFFLE (SH):@{ub} If you use this argument,  all the modules  (or the modules
  684.   in the specified modulelist) will be shuffled. Just like if you press the
  685.   shuffle gadget in the main window.
  686.   @{i}This will  shuffle  all modules in the  modulelist,  including  any  just
  687.   added modules.@{ui}
  688.   @{b}PATH (P):@{ub} This option takes one argument, which is a path.  The path will
  689.   be scanned  for modules, just  like the @{"Start Scan Path" LINK cfgpaths} option. This can
  690.   be used in conjunction with the UNIQUE argument to add files  from a dir,
  691.   which is constantly updated.
  692.   @{b}UNIQUE (U):@{ub} This will avoid any modules to be represented more than  once
  693.   in  the modulelist. This works both with modules, the "Path" argument and
  694.   lha files.
  695.   @{b}NOTE:@{ub} If you specify any modules, a modulelist, or use the PATH argument,
  696.   your @{"scandir" LINK cfgpaths} will be ignored.
  697.   These parameters/tooltypes  can @{b}ONLY@{ub}  be  used  when  APlayer  is already
  698.   running:
  699.   @{b}JUMP (J):@{ub} This will  automatically jump to the  first module  just added,
  700.   independent of your @{"config setting" LINK jumptoaddedmodule}.
  701.   @{b}NOTE@{ub} : If you add modules via the CLI,  APlayer  will  not  automatically
  702.   play them @{b}unless@{ub} you use the JUMP argument.
  703.   @{b}QUIT (Q):@{ub} This  will quit the  player, WITHOUT executing the  arexx macro
  704.   defined in your @{"settings" LINK cfgarexx}.
  705. @ENDNODE
  706. -------------------------------------------------------------------------------
  707. @NODE Thanks
  708. @TITLE "The people and organizations we wish to thank"
  709.   @{u}@{b}Thanks to:@{uu}@{ub}
  710.   @{i}Nico Fran
  711. ois@{ui} for the fabulous Reqtools library and the powerpacker
  712.   library. + Magnus Holmgren for continuing the development of reqtools.
  713.   @{i}Urban Dominik Mueller@{ui} & @{i}Bryan Ford@{ui} for the even more fabulous Xpk master
  714.   library.
  715.   @{i}Jarno Paananen@{ui} for  the source to  his great PS3M, which  made us able to
  716.   support S3M, Fasttracker][ :) and many other formats ...
  717.   @{i}Hans Henrik Happe@{ui} for the cool bar scope agent!
  718.   @{i}John Hendrikx@{ui} for the SQSH library
  719.   @{i}Jorma Oksanen@{ui} for the SMPL library
  720.   @{i}Bo Lincoln@{ui} for the real Quadracomposer player (including the cia and all
  721.   commands)
  722.   @{i}Deftronic@{ui} for Trash'm-One (We hate the enforcer hits!!)
  723.   @{i}Michael Sinz@{ui} for Enforcer
  724.   @{i}Commodore@{ui} for Mungwall and Segtracker
  725.   @{i}Marley/Infect@{ui} for a lot of different moduletypes.
  726.   @{i}Lance Norskog@{ui} for Sox
  727.   All the @{i}authors@{ui} of the different players
  728.   All our @{i}betatesters@{ui}
  729.   @{i}Peter Hjelt@{ui} for the Smartplay which has been a big inspiration source for
  730.   the Accessible Player design.
  731.   @{i}KiLLraVeN/MYSTiC@{ui} Thanks  to  you for  the  bugreports. Keep  them coming.
  732.   (NOT :^) And for the fabulous Arexx script concerning modulelists.
  733.   @{i}Kaikumaa Timo@{ui} for the SoundTracker15 module.
  734.   @{i}Amiga@{ui} for being the best computer EVER (I.... outside!)
  735.   And to @{i}Amiga Technologies/Escom@{ui} for showing a lot of interest in keeping
  736.   developing the Amiga (We are looking forward to the PPC :)
  737. @ENDNODE
  738. -------------------------------------------------------------------------------
  739. @NODE History
  740. @TITLE "The History of AccessiblePlayer"
  741.   @{u}@{b}History:@{uu}@{ub}
  742.   @{"1.00" LINK h100} Released 2-Sep-1994
  743.   @{"1.01" LINK h101} (Not released)
  744.   @{"1.02" LINK h102} (Not released)
  745.   @{"1.03" LINK h103} (Not released)
  746.   @{"1.04" LINK h104} (Not released)
  747.   @{"1.10" LINK h110} Released 27-Dec-1994
  748.   @{"1.20" LINK h120} Released 15-Mar-1995
  749.   @{"1.21" LINK h121} Released 21-Mar-1995
  750.   @{"1.30" LINK h130} Released 29-May-1995
  751.   @{"1.40" LINK h140} Released 7-July-1995
  752.   @{"2.00" LINK h200} Released 27-Dec-1995
  753. @ENDNODE
  754. -------------------------------------------------------------------------------
  755. @NODE h100
  756. @TITLE "The History for Version 1.00"
  757.   1.00 (Released 2-Sep-1994)
  758.   --------------------------
  759.   - First public release.
  760. @ENDNODE
  761. -------------------------------------------------------------------------------
  762. @NODE h101
  763. @TITLE "The History for Version 1.01"
  764.   1.01 (Not released)
  765.   -------------------
  766.   - Ups!!! Fixed a bug in the tune  selector.  You  could  only  select  10
  767.     tunes, even if there were more.
  768.   - Fixed a bug in the Protracker player. It made  a  noisy  sound  if  you
  769.     played an empty sample with the volume command.
  770.   - A little bug fixed in the double buffering loader. If  the  loader  has
  771.     loaded the next module into the memory and you then delete it from  the
  772.     list  before it will start, the player will play it anyway. Now it will
  773.     load the next module instead.
  774.   - If you press the 's' key in the main window,  the  sample  info  window
  775.     will always open, even if the gadget was ghosted. This is fixed now.
  776. @ENDNODE
  777. -------------------------------------------------------------------------------
  778. @NODE h102
  779. @TITLE "The History for Version 1.02"
  780.   1.02 (Not released)
  781.   -------------------
  782.   - The global APG_WaitDMA routine is  changed,  so  it  will  use  EClocks
  783.     instead of raster lines. This mean the global data APG_Hz is obsolete.
  784.   - When APlayer tries to open a file, and it couldn't locate it,  it  will
  785.     now show the filename it tries to open instead of a simple "Object  not
  786.     found" requester.
  787.   - A little bug in the configuration loader. It didn't show an error if it
  788.     couldn't open the file and it cleared all players instead of  only  the
  789.     extern.
  790.   - The module loader will now show an open error requester.
  791.   - The "Delete from list" is changed to "Remove from list".
  792.   - Started to make ARexx interface.
  793. @ENDNODE
  794. -------------------------------------------------------------------------------
  795. @NODE h103
  796. @TITLE "The History for Version 1.03"
  797.   1.03 (Not released)
  798.   -------------------
  799.   - Now APlayer only allocates the channels when a  module  is  in  memory.
  800.     This means, all players are changed a bit and the two global  functions
  801.     APG_AllocChannels and APG_FreeChannels are also changed a bit.
  802.   - Fixed a bug in the IFF-8SVX and RIFF-WAVE player config routine.
  803.   - Changed the SID player to use the playsid.library.
  804. @ENDNODE
  805. -------------------------------------------------------------------------------
  806. @NODE h104
  807. @TITLE "The History for Version 1.04"
  808.   1.04 (Not released)
  809.   -------------------
  810.   - Added the FTM, Whittaker and the TFMX 1.5 player.
  811.   - Changed the loader routine, so now it will cut any fileextension if  it
  812.     couldn't open the file first time. This improves the TFMX loader.
  813.   - A minor bug in the SoundMonitor replayer fixed.
  814.   - A new version of the TFMX 7-Voice player is added. Now you can play the
  815.     Turrican III main tune without a crash after 3 minutes.
  816.   - Also a new version of the TFMX-Professional player is inserted. It will
  817.     not use VBlank anymore.
  818.   - Fixed some small bugs here and there.
  819. @ENDNODE
  820. -------------------------------------------------------------------------------
  821. @NODE h110
  822. @TITLE "The History for Version 1.10"
  823.   1.10 (Released 27-Dec-1994) At the Party '94 in Denmark.
  824.   --------------------------------------------------------
  825.   - Changed all the windows to be auto adjusted.
  826.   - The sample info & the module list windows  are  now  intelligent.  That
  827.     means, they will auto resize to the number of items in the list.
  828.   - Added zoom gadget in the titlebar in the main window.
  829.   - Removed the window positions & sizes from the main preference file into
  830.     and new preference file called APlayer.win. See the docs for more info.
  831.   - Fixed a major bug in the free module routine.  Sometimes  it  closes  a
  832.     library that should not be closed, such as the gadtools.library.
  833.   - Fixed a bug in the QuadraComposer player. It crashed when  it  plays  a
  834.     sample that doesn't exists.
  835.   - Fixed another bug in  the QuadraComposer  player. It crashes the second
  836.     time a module was started.
  837.   - Now you can use the  cursor keys and the return key in the Sample Info,
  838.     Module Editor, FSS and Players window.
  839.   - Players config files are moved to a subdirectory.
  840.   - You  can now  use a lots  of keys to  control the main  window  gadgets
  841.     (hotkeys).
  842.   - Added the Hippel, Hippel-COSO and the PumaTracker player.
  843.   - Added the IFF-AIFF player, and I hate IEEE numbers :^(.
  844.   - Changed the RIFF-WAVE player, so it also support 16-bits samples.
  845.   - You  can  now delete modules from your FSS list now!!! It was like hell
  846.     to make a delete function in a binary tree.
  847.   - The title in the main window are now font sentitive :)
  848.   - The  about  window  are  made  to  a separate window, just like all the
  849.     others.  That  means  it  will  be  updated  every time a new module is
  850.     loaded.
  851.   - HolyNoise player changed to MajorTom player.
  852. @ENDNODE
  853. -------------------------------------------------------------------------------
  854. @NODE h120
  855. @TITLE "The History for Version 1.20"
  856.   1.20 (Released 15-Mar-1995)
  857.   ---------------------------
  858.   - Optimized  the keypad playing. Now will APlayer first start to play the
  859.     sampling and then update the sample window.
  860.   - You can now use the keypad to select a sample when you play a module.
  861.   - Fixed a little bug in all the double click routines.
  862.   - Fixed  a  bug  in the JamCracker player. If you played on the keyboard,
  863.     the sample sounded strange.
  864.   - Fixed a bug in the loader routine.
  865.   - Changed  the  about  window,  so  now  you  can  switch between the two
  866.     "windows".  It  will also  be  updated  every time a module changes CIA
  867.     tempo.
  868.   - Now  you  can  encrypt  your modules with xpk. APlayer will ask for the
  869.     password. It will also unpack recursively. That means you can pack more
  870.     than  one time. You can use this, if you want to pack your modules with
  871.     SQSH and then encrypt them.
  872.   - Fixed a bug in the players own  config. Didn't put  the window to front
  873.     if it was already open.
  874.   - Added  volume  and  channel control and removed an  enforcer hit in the
  875.     Fred player.
  876.   - Added channel  control and song-end to  the Music-Assembler  player and
  877.     fixed  a bug  in the  player (not my fault!), so  now it also  works on
  878.     an A4000.
  879.   - The  Hippel player  is totally rewritten. Still some problems with some
  880.     tunes.
  881.   - Added a lot of new global functions and a few tags.
  882.   - Added the IFF-SMUS player.
  883.   - Added  some  new  CLI  and tooltype  arguments + changed some of them a
  884.     little bit. Now you can start APlayer again with new arguments.
  885.   - Fixed a little bug in the channel on/off keyboard routine.
  886.   - Now you can press return in the about window to close it.
  887.   - Added the Action Amics, In Stereo!, SidMon 1.0 and SidMon 2.0 players.
  888.   - I forgot  to set  the IntuiTicks  IDCMP flag  in all the  windows where
  889.     there was a listview gadget. This is  fixed now, so there should be a
  890.     repeat on the arrows.
  891.   - Added  the  Sonic  Arranger, Sound Control, SoundFX 1.3 and SoundFX 2.0
  892.     player.
  893.   - Fixed some small bugs here and there.
  894.   - Added the TME, Tronic Tracker and the VectorDean player.
  895.   - A  big bug  fixed (when APlayer tries to load the next module in hidden
  896.     mode).
  897.   - Some  small  bugs in  the Protracker player (Thanks to KiLLraVeN/MYSTiC
  898.     for telling us).
  899.   - Changed  all the  listviews. Now  I have  implemented  my own  listview
  900.     routines, and  that means  that the look is the  same on both KS3.0 and
  901.     KS2.0!!!
  902.   - Now the FSS will find out if you have moved some  modules next time you
  903.     hear them.
  904.   - Added Up/Down arrows in the module list editor.
  905.   - Added new Med/OctaMed players. Now supports MMD0/MMD1/MMD2 files.
  906.   - Added multiplay in the sample info window (press "DEL")
  907.   - New intelligent author finding system implemented.
  908. @ENDNODE
  909. ---------------------------------------------------------------------------
  910. @NODE h121
  911. @TITLE "The History for Version 1.21"
  912.   1.21 (Released 21-Mar-1995)
  913.   ---------------------------
  914.   - Due  to  a BIG bug  in version 1.20, which  made APlayer  unuseable  on
  915.     machines below  OS3.0, we  have released this  version, which have been
  916.     succesfully tested on an A600 (OS2.0).
  917.   - The author finding system have been improved on some points.
  918.   - The  name of  the actual module  is displayed in  the titlebar when the
  919.     window gets zipped.
  920.   - A few bugs have been fixed in the SID-, and the MusicAssembler-players.
  921.   - The default  hotkeys in the config  have been modified  a bit, we found
  922.     out  that  "control" couldn't  be  abbreviated  as "ctrl". But  all the
  923.     hotkeys works as always.
  924. @ENDNODE
  925. -------------------------------------------------------------------------------
  926. @NODE h130
  927. @TITLE "The History for Version 1.30"
  928.   1.30 (Released 29-May-1995)
  929.   ---------------------------
  930.   - Added menu in the ARexx configuration window.
  931.   - Changed the player config window design and added menus.
  932.   - Small minor bugs/fixes.
  933.   - Intern ProTracker to ProTracker/NoiseTracker/SoundTracker 15/31
  934.   - New Player Configuration file format (NOT BACKWARDS COMPATIBLE).
  935.   - Made the Paula noteplayer
  936.   - Added 2 new ARexx commands: GetNotePlayer & GetChannels.
  937.   - Renamed the Arexx command "GetType" to "GetPlayer"
  938.   - Added the NotePlayer bit in the "GetInfo" ARexx commando.
  939.   - Changed the Sample Info window.
  940.   - Added the Stereo-32Voices noteplayer.
  941.   - Added the FastTracker, TakeTracker and MultiTracker player.
  942.   - Added  the   FastMem-4Voices,   Mono-32Voices   and   Surround-32Voices
  943.     noteplayers.
  944.   - Optimized the APG_CalcVolume function.
  945.   - Added the RealSurround-32Voices and 14Bit-32Voices noteplayer.
  946.   - Added the ScreamTracker 3.0 and FastTracker 2.0 player.
  947.   - Now  can  you  change  the  tempo  on all players which uses the intern
  948.     interrupt.
  949.   - When you close the main config window, you will not automatic close the
  950.     player and arexx window anymore.
  951.   - Added key file system.
  952.   - Fixed a little bug in the RIFF-WAVE player.
  953.   - The  RexxMsg  field  in  the  main cycle gadget is removed if ARexx not
  954.     turned on.
  955.   - Added  to  the  module  list window titlebar the number of items in the
  956.     module list.
  957.   - Added the DeliCustom player.
  958.   - Fixed  bug  that prevented  resizing of ModuleList-window  after adding
  959.     modules from CLI.
  960.   - Fixed  bug that  tried to load  LhA-icons dropped  on the icon  or main
  961.     window as normal modules.
  962. @ENDNODE
  963. -------------------------------------------------------------------------------
  964. @NODE h140
  965. @TITLE "The History for Version 1.40"
  966.   1.40 (Released 7-July-1995) At the South Sealand Party '95
  967.   ----------------------------------------------------------
  968.   - Oktalyzer uses a NotePlayer now and added a lot of extra features.
  969.   - Fixed a mixing bug in the Mono-NotePlayer.  It  mixes the channels in a
  970.     wrong order.
  971.   - If  you  play  a module and you have the player config window open, you
  972.     can  see  which  player  is  active. If you then choose one of the menu
  973.     items  that  load  a  new  config  file,  the active player will not be
  974.     highlighted again if it is in the list. This is fixed now.
  975.   - Fixed  a  bug  in  the  Pro/NoiseTracker player. It didn't mask out the
  976.     finetune  value,  and  therefore  with  some  modules  if  sounds  very
  977.     abstract.
  978.   - QuadraComposer and JamCracker uses a NotePlayer now.
  979.   - If you try to play some AM samples and the player uses a NotePlayer, it
  980.     try to play it. This is fixed now.
  981.   - FutureComposer 1.0-1.3 and FutureComposer 1.4 uses a NotePlayer now.
  982.   - Now  you  can use the KEYPATH enviroment variable to the path where you
  983.     have stored your key-file.
  984.   - The playing module is now highlighted both in the main window and i the
  985.     modulelist.
  986.   - Added the Art Of Noise player.
  987.   - Fixed a pausing bug in the FTM player (Thanks Hans Malte Kern :=)
  988.   - NEW! Agent sample save interface created.
  989.   - Fixed a serius bug i Paula-noteplayeren. Sometimes it made some strange
  990.     sounds.
  991. @ENDNODE
  992. -------------------------------------------------------------------------------
  993. @NODE h200
  994. @TITLE "The History for Version 2.00"
  995.   2.00 (Released 27-Dec-1995)
  996.   ---------------------------
  997.   - Rewritten the Fibonacci encoding for IFF-8SVX, now it works 100%
  998.   - Added a progress bar when you convert or save samples.
  999.   - Added  some players: Activision  Pro, Delta  Music  2.0,  SoundFactory,
  1000.     MarkII, TimFolin, Voodoo Supreme Synthesizer, Mark Cooksey, J.C.Brooke
  1001.     and Sound Monitor 2.2.
  1002.   - The IFF-8SVX, IFF-AIFF and RIFF-WAVE players now uses Noteplayers.
  1003.   - Added "Play Once" to the sample players.
  1004.   - Added IFF-AIFF, RIFF-WAVE and RAW sample converters.
  1005.   - MED now uses Noteplayers. Do not use the Fastmem  noteplayer  with  MED
  1006.     with synth sounds, they will be skipped.
  1007.   - No matter which window you have activated, you can choose which subsong
  1008.     to play (with 0-9 +/-) Previously  this was not possible  in the config
  1009.     and show windows.
  1010.   - The IFF-8SVX sample saver now also saves the author name.
  1011.   - Added the Scope Interface (Graphical scopes to everyone). This includes
  1012.     the RGB box, Spinning Squares and the Bar-Scope.
  1013.   - We will NOT guarantee anything if you use FAKE key files for APlayer.
  1014.   - The (?/?) will show the module position when you zip the main window.
  1015.   - The CX_PRI argument now works correctly.
  1016.   - If you  add modules  via the CLI, APlayer  will not  automatically play
  1017.     them unless you use the JUMP argument.
  1018.   - Pressing <shift>+Eject will delete all but the playing module.
  1019.   - Pressing <shift>+Del button  in the Modulelist  window will  delete all
  1020.     double instances of module.
  1021.   - Pressing <ctrl> + <return> in  the Modulelist  window will  select  the
  1022.     playing module.
  1023.   - Updated the Noteplayers to use Jarno paananens S3M version 3.12.
  1024.   - Added the new configuration interface.
  1025.   - Fixed a bug which could cause APlayer to crash under OS2.0
  1026.   - Added the why function in error requesters.
  1027.   - Added Online Help (Place pointer and press <HELP>)
  1028.   - Warning! If  you use  the  XFH package  on your harddisk, do not  do an
  1029.     "Avail flush" command. Due  to unknown reasons this will  cause several
  1030.     programs, including APlayer, to crash.
  1031.   - + the usual amount of bug fixes :)
  1032. @ENDNODE
  1033. -------------------------------------------------------------------------------
  1034. @NODE contact
  1035. @TITLE "Contact addresses"
  1036.   Send bugreports, new players including modules and suggestions to
  1037.   Coder:
  1038.   ------
  1039.   Thomas Neumann (Tax)
  1040.   Kongensgade 78
  1041.   3550 Slangerup
  1042.   Denmark
  1043.   Send technotapes and modules to
  1044.   Designer, Alphatester & Guide writer:
  1045.   -------------------------------------
  1046.   Jakob Langgaard (Jail)
  1047.   Krebsen 101
  1048.   3650 
  1049. lstykke
  1050.   Denmark
  1051.   E-mail: jail@diku.dk
  1052.   Designer & Betatester:
  1053.   ----------------------
  1054.   Asger H
  1055. gsted
  1056.   bims@diku.dk (internet)
  1057. @ENDNODE
  1058. --------------------------------------------------------------------------
  1059. @NODE ArexxMain
  1060. @TITLE "ARexx"
  1061.   @{b}@{u}ARexx with the APlayer:@{ub}@{uu}
  1062.   This section will describe all  the  commands  available  for  the  ARexx
  1063.   interface  in APlayer. If you don't know anything about ARexx, you should
  1064.   either skip this part, or try to find some documentation on the subject.
  1065.   To help you to get a better overview of the commands, we have split  into
  1066.   the following sections:
  1067.   @{" Channels   " LINK ARChannel} - Manipulate Channels
  1068.   @{" Eject      " LINK AREject} - Controls the Eject Function
  1069.   @{" Loop       " LINK ARLoop} - Change Loop
  1070.   @{" Main Cycle " LINK ARMaincycle} - Manipulate the Main Cycle
  1071.   @{" Modulelist " LINK ARModulelist} - Manipulate the Module list
  1072.   @{" Pause      " LINK ARPause} - Change the Pause state
  1073.   @{" Play       " LINK ARPlay} - What to Play
  1074.   @{" Requester  " LINK ARRequester} - Make ReqTools Requsters
  1075.   @{" Sample     " LINK ARSample} - Use the Sample Functions
  1076.   @{" Speed      " LINK ARSpeed} - Change/Get the Speed State
  1077.   @{" Tech Info  " LINK ARTechnical} - Get a lot of Technical Info
  1078.   @{" Various    " LINK ARVarious} - Miscellaneous
  1079.   @{" Volume     " LINK ARVolume} - Change/Get the Volume State
  1080.   @{" Wind       " LINK ARWind} - Forward/Rewind
  1081.   @{" Window     " LINK ARWindow} - Window Commands
  1082. @ENDNODE
  1083. ------------------------------------------------------------------------
  1084. @NODE ARChannel
  1085. @TITLE "Channels"
  1086.   @{b}@{u}Channels:@{ub}@{uu}
  1087.   @{b}Command:@{ub}
  1088.     ChannelOff @{i}channel@{ui}
  1089.   @{b}Description:@{ub}
  1090.     Turns off the channel "channel".
  1091.   @{b}Input:@{ub}
  1092.     channel - A channel number between 1 and 4.
  1093.   @{b}Result:@{ub}
  1094.     None.
  1095.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1096.   @{b}Command:@{ub}
  1097.     ChannelOn @{i}channel@{ui}
  1098.   @{b}Description:@{ub}
  1099.     Turns on the channel "channel".
  1100.   @{b}Input:@{ub}
  1101.     channel - A channel number between 1 and 4.
  1102.   @{b}Result:@{ub}
  1103.     None.
  1104.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1105.   @{b}Command:@{ub}
  1106.     state = GetChannel @{i}channel@{ui}
  1107.   @{b}Description:@{ub}
  1108.     Get the current state of the channel "channel".
  1109.   @{b}Input:@{ub}
  1110.     channel - A channel number between 1 and 4.
  1111.   @{b}Result:@{ub}
  1112.     state - This is a boolean where FALSE means off and TRUE means on.
  1113.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1114.   @{b}Command:@{ub}
  1115.     state = ToggleChannel @{i}channel@{ui}
  1116.   @{b}Description:@{ub}
  1117.     Toggles the state of the channel "channel".
  1118.   @{b}Input:@{ub}
  1119.     channel - A channel number between 1 and 4.
  1120.   @{b}Result:@{ub}
  1121.     state - This is a boolean where FALSE means off and TRUE means on.
  1122. @ENDNODE
  1123. ------------------------------------------------------------------------
  1124. @NODE AReject
  1125. @TITLE "Eject"
  1126.   @{b}Command:@{ub}
  1127.     ClearList
  1128.   @{b}Description:@{ub}
  1129.     This will eject the current playing module, and free the  rest  of  the
  1130.     list. Which is the same as if you've clicked the eject button 2 times.
  1131.   @{b}Input:@{ub}
  1132.     None
  1133.   @{b}Result:@{ub}
  1134.     None
  1135.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1136.   @{b}Command:@{ub}
  1137.     Eject
  1138.   @{b}Description:@{ub}
  1139.     This will either eject the currently playing module or eject the  whole
  1140.     list.  If a module is being played it will be ejected, and if no module
  1141.     is loaded played the list will be ejected.
  1142.   @{b}Input:@{ub}
  1143.     None
  1144.   @{b}Result:@{ub}
  1145.     None
  1146. @ENDNODE
  1147. ------------------------------------------------------------------------
  1148. @NODE ARLOOP
  1149. @TITLE "LOOP"
  1150.   @{b}Command:@{ub}
  1151.     state = GetLoop
  1152.   @{b}Description:@{ub}
  1153.     Get the current state of the loop gadget. The result is a boolean and 1
  1154.     means on and 0 means off.
  1155.   @{b}Input:@{ub}
  1156.     None
  1157.   @{b}Result:@{ub}
  1158.     state - This is a boolean where FALSE means off and TRUE means on.
  1159.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1160.   @{b}Command:@{ub}
  1161.     LoopOff
  1162.   @{b}Description:@{ub}
  1163.     Set the loop to off.
  1164.   @{b}Input:@{ub}
  1165.     None
  1166.   @{b}Result:@{ub}
  1167.     None
  1168.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1169.   @{b}Command:@{ub}
  1170.     LoopOn
  1171.   @{b}Description:@{ub}
  1172.     Turns the loop on.
  1173.   @{b}Input:@{ub}
  1174.     None
  1175.   @{b}Result:@{ub}
  1176.     None
  1177.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1178.   @{b}Command:@{ub}
  1179.     state = ToggleLoop
  1180.   @{b}Description:@{ub}
  1181.     Toggles the loop and return the new state.
  1182.   @{b}Input:@{ub}
  1183.     None
  1184.   @{b}Result:@{ub}
  1185.     state - This is a boolean where FALSE means off and TRUE means on.
  1186. @ENDNODE
  1187. ------------------------------------------------------------------------
  1188. @NODE ARMAINCYCLE
  1189. @TITLE "MainCycle"
  1190.   @{b}Command:@{ub}
  1191.     name = GetCycle
  1192.   @{b}Description:@{ub}
  1193.     Get the current position of the main cycle. It  will  return  a  string
  1194.     with the cycle name, like Author.
  1195.   @{b}Input:@{ub}
  1196.     None
  1197.   @{b}Result:@{ub}
  1198.     name - a string with the name of the cycleposition.
  1199.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1200.   @{b}Command:@{ub}
  1201.     RexxMsg @{i}string@{ui}
  1202.   @{b}Description:@{ub}
  1203.     Changes the contents of the REXXMSG in the main cycle.
  1204.   @{b}Input:@{ub}
  1205.     String - a normal text string.
  1206.   @{b}Result:@{ub}
  1207.     None
  1208.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1209.   @{b}Command:@{ub}
  1210.     error = SetCycle @{i}name@{ui}
  1211.   @{b}Description:@{ub}
  1212.     Set the main cycle to the "name", like SetCycle Author. It will  return
  1213.     an error if it couldn't find the name.
  1214.   @{b}Input:@{ub}
  1215.     name - a string with the name of the cycleposition.
  1216.   @{b}Result:@{ub}
  1217.     error - an error code which indicates if it could find the name in  the
  1218.             cycle. 0 means ok and 1 means error. Note that the result is in
  1219.             RC and not in RESULT.
  1220. @ENDNODE
  1221. ------------------------------------------------------------------------
  1222. @NODE ARMODULELIST
  1223. @TITLE "ModuleList"
  1224.   @{b}Command:@{ub}
  1225.     error = AddMod @{i}file@{ui}
  1226.   @{b}Description:@{ub}
  1227.     Adds the module with the name "file" to the module list.
  1228.   @{b}Input:@{ub}
  1229.     file - the name of the module you want to add.
  1230.   @{b}Result:@{ub}
  1231.     error - if it can't find the file. 0 means ok and 1 means  error.  Note
  1232.             that  the  result  is  in  that  the result is in RC and not in
  1233.             RESULT.
  1234.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1235.   @{b}Command:@{ub}
  1236.     AppendList @{i}num file@{ui}
  1237.   @{b}Description:@{ub}
  1238.     Adds a module list with the name "file" to the module  list.  "num"  is
  1239.     the number in the list you want to insert the new list at. -1 means the
  1240.     buttom of the list.
  1241.   @{b}Input:@{ub}
  1242.     num - the position where you want to insert.
  1243.     file - the modulelist to insert.
  1244.   @{b}Result:@{ub}
  1245.     error = this is an error code where 0 means ok and 1 means error.  Note
  1246.             that the result is in RC not in RESULT.
  1247.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1248.   @{b}Command:@{ub}
  1249.     error = DelMod @{i}num@{ui}
  1250.   @{b}Description:@{ub}
  1251.     Deletes the module "num" in the module list.
  1252.   @{b}Input:@{ub}
  1253.     num - the number of the module to be deleted from  the  list,  starting
  1254.           from 1.
  1255.   @{b}Result:@{ub}
  1256.     error = this is an error code where 0 means ok and 1 means error.  Note
  1257.             that the result is in RC not in RESULT.
  1258.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1259.   @{b}Command:@{ub}
  1260.     error = ExgMods @{i}num1 num2@{ui}
  1261.   @{b}Description:@{ub}
  1262.     Exchange the two modules "num1" and "num2" in the module list.
  1263.   @{b}Input:@{ub}
  1264.     num1 and num2 - the number of the modules  to be exchanged in the list,
  1265.                     starting with 1.
  1266.   @{b}Result:@{ub}
  1267.     error = this is an error code where 0 means ok and 1 means error.  Note
  1268.             that the result is in RC not in RESULT.
  1269.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1270.   @{b}Command:@{ub}
  1271.     max = GetMaxNames
  1272.   @{b}Description:@{ub}
  1273.     Returns the number of modules in the module list.
  1274.   @{b}Input:@{ub}
  1275.     None
  1276.   @{b}Result:@{ub}
  1277.     max - the number of modules in the list.
  1278.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1279.   @{b}Command:@{ub}
  1280.     name = GetModName @{i}num@{ui}
  1281.   @{b}Description:@{ub}
  1282.     Returns the name of the module with the number "num" with full path.
  1283.   @{b}Input:@{ub}
  1284.    num - the number of the module from which you want  the  name,  starting
  1285.          with 1.
  1286.   @{b}Result:@{ub}
  1287.     error = this is an error code where 0 means ok and 1 means error.  Note
  1288.             that the result is in RC not in RESULT.
  1289.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1290.   @{b}Command:@{ub}
  1291.     num = GetModNum @{i}name@{ui}
  1292.   @{b}Description:@{ub}
  1293.     This will return the number of the module named "name". If it  couldn't
  1294.     find the name, a zero will be returned.
  1295.   @{b}Input:@{ub}
  1296.     name - the file name (without path) of the module in the list.
  1297.   @{b}Result:@{ub}
  1298.     num - the number of the module in the  list.
  1299.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1300.   @{b}Command:@{ub}
  1301.     LoadList @{i}file@{ui}
  1302.   @{b}Description:@{ub}
  1303.     Loads a new APML list with the filename "file".
  1304.   @{b}Input:@{ub}
  1305.     file - the name of the modulelist to be loaded.
  1306.   @{b}Result:@{ub}
  1307.     None
  1308.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1309.   @{b}Command:@{ub}
  1310.     error = SaveList @{i}file@{ui}
  1311.   @{b}Description:@{ub}
  1312.     Saves the current module list with the filename "file". If  the  module
  1313.     list is empty, an error will be returned.
  1314.   @{b}Input:@{ub}
  1315.     file - the name of the modulelist to be saved.
  1316.   @{b}Result:@{ub}
  1317.     error = this is an error code where 0 means ok and 1 means error.  Note
  1318.             that the result is in RC not in RESULT.
  1319.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1320.   @{b}Command:@{ub}
  1321.     Shuffle
  1322.   @{b}Description:@{ub}
  1323.     Shuffles the modulelist.
  1324.   @{b}Input:@{ub}
  1325.     None
  1326.   @{b}Result:@{ub}
  1327.     None
  1328.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1329.   @{b}Command:@{ub}
  1330.     SortList
  1331.   @{b}Description:@{ub}
  1332.     Sorts the modulelist in alphabetical order.
  1333.   @{b}Input:@{ub}
  1334.     None
  1335.   @{b}Result:@{ub}
  1336.     None
  1337. @ENDNODE
  1338. ------------------------------------------------------------------------
  1339. @NODE ARPAUSE
  1340. @TITLE "Pause"
  1341.   @{b}Command:@{ub}
  1342.     error = Pause
  1343.   @{b}Description:@{ub}
  1344.     Pauses the current module. If the current  player can't pause or  there
  1345.     aren't any modules in the memory, an error will be returned.
  1346.   @{b}Input:@{ub}
  1347.     None
  1348.   @{b}Result:@{ub}
  1349.     error = this is an error code where 0 means ok and 1 means error.  Note
  1350.             that the result is in RC not in RESULT.
  1351.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1352.   @{b}Command:@{ub}
  1353.     error = TogglePause
  1354.   @{b}Description:@{ub}
  1355.     Toggles the pause state of the current module. If  the  current  player
  1356.     can't pause or there aren't any modules in the memory, an error will be
  1357.     returned.
  1358.   @{b}Input:@{ub}
  1359.     None
  1360.   @{b}Result:@{ub}
  1361.     error = this is an error code where 0 means ok and 1 means error.  Note
  1362.             that the result is in RC not in RESULT.
  1363.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1364.   @{b}Command:@{ub}
  1365.     error = Unpause
  1366.   @{b}Description:@{ub}
  1367.     Starts playing again. If the current player can't pause or there aren't
  1368.     any modules in the memory, an error will be returned.
  1369.   @{b}Input:@{ub}
  1370.     None
  1371.   @{b}Result:@{ub}
  1372.     error = this is an error code where 0 means ok and 1 means error.  Note
  1373.             that the result is in RC not in RESULT.
  1374. @ENDNODE
  1375. ------------------------------------------------------------------------
  1376. @NODE ARPLAY
  1377. @TITLE "Play"
  1378.   @{b}Command:@{ub}
  1379.     Play
  1380.   @{b}Description:@{ub}
  1381.     This will do the same as if you pressed the play button.
  1382.   @{b}Input:@{ub}
  1383.     None
  1384.   @{b}Result:@{ub}
  1385.     None
  1386.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1387.   @{b}Command:@{ub}
  1388.     error = PlayMod @{i}num@{ui}
  1389.   @{b}Description:@{ub}
  1390.     Load and start the module with the number "num" (1 - x) in  the  module
  1391.     list. If the "num" doesn't exist, an error will be returned.
  1392.   @{b}Input:@{ub}
  1393.     num - the number of the module you want to play, starting with 1.
  1394.   @{b}Result:@{ub}
  1395.     error = this is an error code where 0 means ok and 1 means error.  Note
  1396.             that the result is in RC not in RESULT.
  1397.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1398.   @{b}Command:@{ub}
  1399.     error = PlayRNDMod
  1400.   @{b}Description:@{ub}
  1401.     Loads and starts a random module from the list.
  1402.   @{b}Input:@{ub}
  1403.     None
  1404.   @{b}Result:@{ub}
  1405.     error = this is an error code where 0 means ok and 1 means error.  Note
  1406.             that the result is in RC not in RESULT.
  1407.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1408.   @{b}Command:@{ub}
  1409.     error = PlayTune @{i}num@{ui}
  1410.   @{b}Description:@{ub}
  1411.     Start to play the tune "num".  An error is returned if the "num" is out
  1412.     of range. Note that this is for subsongs, like in sid modules.
  1413.   @{b}Input:@{ub}
  1414.     num - the number of the tune you want to play, starting with 1.
  1415.   @{b}Result:@{ub}
  1416.     error = this is an error code where 0 means ok and 1 means error.  Note
  1417.         that the result is in RC not in RESULT.
  1418.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1419.   @{b}Command:@{ub}
  1420.     NextMod
  1421.   @{b}Description:@{ub}
  1422.     Loads and plays the next module in the list. If only one module in  the
  1423.     list,  nothing  will  happend.  If  an error occurs the player will act
  1424.     exactly the same way as if you've pressed the next module button in the
  1425.     main window.
  1426.   @{b}Input:@{ub}
  1427.     None
  1428.   @{b}Result:@{ub}
  1429.     None
  1430.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1431.   @{b}Command:@{ub}
  1432.     PrevMod
  1433.   @{b}Description:@{ub}
  1434.     Loads and plays the Previous module in the list. If only one module  in
  1435.     the  list, nothing will happend. If an error occurs the player will act
  1436.     exactly the same way as if you've pressed the Previous module button in
  1437.     the main window.
  1438.   @{b}Input:@{ub}
  1439.     None
  1440.   @{b}Result:@{ub}
  1441.     None
  1442. @ENDNODE
  1443. ------------------------------------------------------------------------
  1444. @NODE ARRequester
  1445. @TITLE "Requester"
  1446.   @{b}Command:@{ub}
  1447.     dir,success = GetDir @{i}title@{ui}
  1448.   @{b}Description:@{ub}
  1449.     Popups a file requester where the user can pick one directory.  If  the
  1450.     user  selects cancel, "success" will be 1, else it will be 0.
  1451.   @{b}Input:@{ub}
  1452.     title - a string which contains the name of the requester title.
  1453.   @{b}Result:@{ub}
  1454.     dir     - the path the user has selected.
  1455.     success - this is an error code where 0 means ok  and  1  means  error.
  1456.               Note  that the result is in RC not in RESULT.
  1457.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1458.   @{b}Command:@{ub}
  1459.     name,success = GetFile @{i}title@{ui}
  1460.   @{b}Description:@{ub}
  1461.     Popups a file requester where the user can pick one file. If  the  user
  1462.     selects cancel, "success" will be 1, else it will be 0.
  1463.   @{b}Input:@{ub}
  1464.     title - a string which contains the name of the requester title.
  1465.   @{b}Result:@{ub}
  1466.     file    - the filename with path which the user has selected.
  1467.     success - this is an error code where 0 means ok  and  1  means  error.
  1468.               Note that the result is in RC not in RESULT.
  1469.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1470.   @{b}Command:@{ub}
  1471.     num,success = GetNumber @{i}min max title@{ui}
  1472.   @{b}Description:@{ub}
  1473.     Popups a number requester where the user can write  a  number.  If  the
  1474.     user selects cancel, "success" will be 1, else it will be 0.
  1475.   @{b}Input:@{ub}
  1476.     min   - the minimum of the range.
  1477.     max   - the maximum of the range.
  1478.     title - a string which contains the name of the requester title.
  1479.   @{b}Result:@{ub}
  1480.     num     - the number the user has written.
  1481.     success - this is an error code where 0 means ok  and  1  means  error.
  1482.               Note that the result is in RC not in RESULT.
  1483.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1484.   @{b}Command:@{ub}
  1485.     string,success = GetString @{i}title@{ui}
  1486.   @{b}Description:@{ub}
  1487.     Popups a string requester where the user can write  a  string.  If  the
  1488.     user  selects  cancel,  "success"  will  be  1,  else it will be 0. The
  1489.     "string" will be the entered string.
  1490.   @{b}Input:@{ub}
  1491.     title - a string which contains the name of the requester title.
  1492.   @{b}Result:@{ub}
  1493.     string  - the string which the user have typed.
  1494.     success - this is an error code where 0 means ok  and  1  means  error.
  1495.               Note that the result is in RC not in RESULT.
  1496.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1497.   @{b}Command:@{ub}
  1498.     pressed = Request @{i}gadget text@{ui}
  1499.   @{b}Description:@{ub}
  1500.     This will popup a requester where the user can select between a  couple
  1501.     of  gadgets,  like ok and cancel. The "gadget" is a string with all the
  1502.     gadgets you want in the requester seperated with a "|",  ex."ok|cancel"
  1503.     or "yes|maybe|no".
  1504.   @{b}Input:@{ub}
  1505.     gadget - a string with the gadget names.
  1506.     text   - the text which is printed in the requester window.
  1507.   @{b}Result:@{ub}
  1508.     pressed - the number of the gadget which  the  user  has  pressed.  The
  1509.               rightmost gadget is number 0, the  rest  of  the  gadgets  is
  1510.               numbered from left to right.
  1511. @ENDNODE
  1512. ------------------------------------------------------------------------
  1513. @NODE ARsample
  1514. @TITLE "Sample"
  1515.   @{b}Command:@{ub}
  1516.     name,success = GetSampleName @{i}num@{ui}
  1517.   @{b}Description:@{ub}
  1518.     Get the samplename from the sample number "num". If the number  is  out
  1519.     of range then success will be 1, and name will contain crap.
  1520.     The range of numbers could vary from moduleformat to moduleformat.
  1521.   @{b}Input:@{ub}
  1522.     num - the number of the sample from which you want the name.
  1523.   @{b}Result:@{ub}
  1524.     name    - the samplename
  1525.     success - this is an error code where 0 means ok  and  1  means  error.
  1526.               Note that the result is in RC not in RESULT.
  1527.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1528.   @{b}Command:@{ub}
  1529.     success = Savesample @{i}num filename@{ui}
  1530.   @{b}Description:@{ub}
  1531.     Saves the sample "number" with the name  "filename".  This  returns  an
  1532.     error if the sample number is out of range or the size is 0.
  1533.   @{b}Input:@{ub}
  1534.     num      - the samplenumber
  1535.     filename - the name you want the sample to.
  1536.   @{b}Result:@{ub}
  1537.     success - this is an error code where 0 means ok  and  1  means  error.
  1538.               Note that the result is in RC not in RESULT.
  1539.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1540.   @{b}Command:@{ub}
  1541.     StopSample
  1542.   @{b}Description:@{ub}
  1543.     Stops the playing sample.
  1544.   @{b}Input:@{ub}
  1545.     None
  1546.   @{b}Result:@{ub}
  1547.     None
  1548.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1549.   @{b}Command:@{ub}
  1550.     success = PlaySample {i}num note@{ui}
  1551.   @{b}Description:@{ub}
  1552.     Play  the  sample  "num"  with  the note "note". The "num" value can be
  1553.     between  1  and  the  max  number of samples the player can handle. The
  1554.     "note"  value can be between 0 and 35. 0 means C-1 and 35 means B-3. If
  1555.     the current player can't play the sample, an error will be returned.
  1556.   @{b}Input:@{ub}
  1557.     num  - the samplenumber
  1558.     note - the note number
  1559.   @{b}Result:@{ub}
  1560.     success - this is an error code where 0 means ok  and  1  means  error.
  1561.               Note that the result is in RC not in RESULT.
  1562. @ENDNODE
  1563. ------------------------------------------------------------------------
  1564. @NODE ARSpeed
  1565. @TITLE "Speed"
  1566.   @{b}Command:@{ub}
  1567.     speed = GetSpeed
  1568.   @{b}Description:@{ub}
  1569.     Get the current speed slider position and place the result in  "speed".
  1570.     The result is a signed integer.
  1571.   @{b}Input:@{ub}
  1572.     None
  1573.   @{b}Result:@{ub}
  1574.     speed - the current speed
  1575.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1576.   @{b}Command:@{ub}
  1577.     SetSpeed @{i}speed@{ui}
  1578.   @{b}Description:@{ub}
  1579.     Set the speed to "speed". "Speed"  can  range  from  -111  to  112.  If
  1580.     "speed" is  out of range  the  speed  will  be set to either maximum or
  1581.     minimum.
  1582.   @{b}Input:@{ub}
  1583.     speed - the speed to be set
  1584.   @{b}Result:@{ub}
  1585.     None
  1586.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1587.   @{b}Command:@{ub}
  1588.     speed = SpeedDown
  1589.   @{b}Description:@{ub}
  1590.     Move the CIA speed one tick down.
  1591.   @{b}Input:@{ub}
  1592.     None
  1593.   @{b}Result:@{ub}
  1594.     speed - The new speed
  1595.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1596.   @{b}Command:@{ub}
  1597.     speed = SpeedUp
  1598.   @{b}Description:@{ub}
  1599.     Move the CIA speed one tick up.
  1600.   @{b}Input:@{ub}
  1601.     None
  1602.   @{b}Result:@{ub}
  1603.     speed - The new speed
  1604. @ENDNODE
  1605. ------------------------------------------------------------------------
  1606. @NODE ARTechnical
  1607. @TITLE "Technical"
  1608.   @{b}Command:@{ub}
  1609.     author = GetAuthor
  1610.   @{b}Description:@{ub}
  1611.     Returns the author of the current playing module.  If  there  isn't  an
  1612.     author it will return unknown.
  1613.   @{b}Input:@{ub}
  1614.     None
  1615.   @{b}Result:@{ub}
  1616.     author - The name of the author
  1617.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1618.   @{b}Command:@{ub}
  1619.     name = GetChannels
  1620.   @{b}Description:@{ub}
  1621.     Returns the number of  used channels.  This is virtual channels, which
  1622.     means that it can vary from 1 to 32 channels.
  1623.   @{b}Input:@{ub}
  1624.     None
  1625.   @{b}Result:@{ub}
  1626.     type - the number of used channels.
  1627.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1628.   @{b}Command:@{ub}
  1629.     num = GetCMod
  1630.   @{b}Description:@{ub}
  1631.     Returns the current playing module number. 0 if no module is playing.
  1632.   @{b}Input:@{ub}
  1633.     None
  1634.   @{b}Result:@{ub}
  1635.     num - the number of the current module
  1636.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1637.   @{b}Command:@{ub}
  1638.     name = GetFilename @{i}num flag@{ui}
  1639.   @{b}Description:@{ub}
  1640.     Returns the module filename. "num" is the module number in  the  module
  1641.     list. "flag" indicates if you want path. 0 means no, 1 means yes.
  1642.   @{b}Input:@{ub}
  1643.     num  - the module number
  1644.     flag - path or not (see above)
  1645.   @{b}Result:@{ub}
  1646.     name - the filename
  1647.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1648.   @{b}Command:@{ub}
  1649.     info = GetInfo
  1650.   @{b}Description:@{ub}
  1651.     Will return a longword where each bit represent the  information  about
  1652.     the current player. Below is a table of the bits returned.
  1653.     Bit                   Bit
  1654.     0 = Rewind             10 = Length
  1655.     1 = Forward            11 = Position
  1656.     2 = Pause              12 = Max Patterns
  1657.     3 = Volume             13 = Show Samples
  1658.     4 = Fade               14 = Play Samples
  1659.     5 = Tempo              15 = Accompany
  1660.     6 = Channels           16 = Force Filter Off
  1661.     7 = Modulename         17 = FastMem
  1662.     8 = Author             18 = Own Config
  1663.     9 = SubSongs           19 = Noteplayer
  1664.   @{b}Input:@{ub}
  1665.     None
  1666.   @{b}Result:@{ub}
  1667.     info - a number containing the above bits
  1668.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1669.   @{b}Command:@{ub}
  1670.     len = GetLength
  1671.   @{b}Description:@{ub}
  1672.     Get the length of the current  playing  module.  If  the  length  isn't
  1673.     available 0 will be returned.
  1674.   @{b}Input:@{ub}
  1675.     None
  1676.   @{b}Result:@{ub}
  1677.     len - the song length
  1678.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1679.   @{b}Command:@{ub}
  1680.     max = GetMaxPatterns
  1681.   @{b}Description:@{ub}
  1682.     Returns the number of patterns in the current playing  module.  If  the
  1683.     number of patterns isn't available 0 will be returned.
  1684.   @{b}Input:@{ub}
  1685.     None
  1686.   @{b}Result:@{ub}
  1687.     max - number of patterns
  1688.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1689.   @{b}Command:@{ub}
  1690.     max = GetMaxSamples
  1691.   @{b}Description:@{ub}
  1692.     Returns the max number of samples the current player can handle. If the
  1693.     player can't handle any samples, 0 will be returned.
  1694.   @{b}Input:@{ub}
  1695.     None
  1696.   @{b}Result:@{ub}
  1697.     max - the max number of samples
  1698.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1699.   @{b}Command:@{ub}
  1700.     max = GetMaxTunes
  1701.   @{b}Description:@{ub}
  1702.     Get the max number of tunes in the  current  playing  module.  It  will
  1703.     return 0 if there isn't a module in memory.
  1704.   @{b}Input:@{ub}
  1705.     None
  1706.   @{b}Result:@{ub}
  1707.     max - the number of tunes
  1708.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1709.   @{b}Command:@{ub}
  1710.     rate = GetMixingRate
  1711.   @{b}Description:@{ub}
  1712.     This get the actual mixing rate used by the  used  noteplayer. It  will
  1713.     return  0  if  there isn't a module in memory or if no noteplayer, with
  1714.     mixing routines, is in use.
  1715.   @{b}Input:@{ub}
  1716.     None
  1717.   @{b}Result:@{ub}
  1718.     rate - The mixing rate
  1719.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1720.   @{b}Command:@{ub}
  1721.     name = GetName
  1722.   @{b}Description:@{ub}
  1723.     Returns the name of  the  current  playing  module.  This  is  not  the
  1724.     filename  but the name of the module taken from the module. If it isn't
  1725.     available it will return the filename.
  1726.   @{b}Input:@{ub}
  1727.     None
  1728.   @{b}Result:@{ub}
  1729.     name - the module name
  1730.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1731.   @{b}Command:@{ub}
  1732.     name = GetNotePlayer
  1733.   @{b}Description:@{ub}
  1734.     Returns the name of the current noteplayer.
  1735.   @{b}Input:@{ub}
  1736.     None
  1737.   @{b}Result:@{ub}
  1738.     type - the noteplayer name
  1739.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1740.   @{b}Command:@{ub}
  1741.     type = GetPlayer
  1742.   @{b}Description:@{ub}
  1743.     Returns the name of the current used player library, eg. Protracker or
  1744.     Future Composer.
  1745.   @{b}Input:@{ub}
  1746.     None
  1747.   @{b}Result:@{ub}
  1748.     type - the player name
  1749.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1750.   @{b}Command:@{ub}
  1751.     mode = GetPlayMode
  1752.   @{b}Description:@{ub}
  1753.     Get the current playing state. The result is  a  boolean  and  1  means
  1754.     VBlank and 0 means CIA.
  1755.   @{b}Input:@{ub}
  1756.     None
  1757.   @{b}Result:@{ub}
  1758.     mode - the current playing state
  1759.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1760.   @{b}Command:@{ub}
  1761.     pos = GetPosition
  1762.   @{b}Description:@{ub}
  1763.     Get the current position. If the current player can't get the position,
  1764.     -1 will be returned.
  1765.   @{b}Input:@{ub}
  1766.     None
  1767.   @{b}Result:@{ub}
  1768.     pos - the current position
  1769.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1770.   @{b}Command:@{ub}
  1771.     size = GetSize
  1772.   @{b}Description:@{ub}
  1773.     Get the filesize (unpacked) in bytes of the current playing module.
  1774.   @{b}Input:@{ub}
  1775.     None
  1776.   @{b}Result:@{ub}
  1777.     size - the module size
  1778.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1779.   @{b}Command:@{ub}
  1780.     tune = GetTune
  1781.   @{b}Description:@{ub}
  1782.     Get the current playing tune number.
  1783.   @{b}Input:@{ub}
  1784.     None
  1785.   @{b}Result:@{ub}
  1786.     tune - the current tune number
  1787.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1788.   @{b}Command:@{ub}
  1789.     success = SetAuthor @{i}author@{ui}
  1790.   @{b}Description:@{ub}
  1791.     Change the author. It will return an error if no module is in memory.
  1792.   @{b}Input:@{ub}
  1793.     author - the new author name
  1794.   @{b}Result:@{ub}
  1795.     success - this is an error code where 0 means ok  and  1  means  error.
  1796.               Note that the result is in RC not in RESULT.
  1797.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1798.   @{b}Command:@{ub}
  1799.     success = SetName @{i}name@{ui}
  1800.   @{b}Description:@{ub}
  1801.     Change  the  module  name.  It  will return an error if no module is in
  1802.     memory.
  1803.   @{b}Input:@{ub}
  1804.     name - the new module name
  1805.   @{b}Result:@{ub}
  1806.     success - this is an error code where 0 means ok  and  1  means  error.
  1807.               Note that the result is in RC not in RESULT.
  1808. @ENDNODE
  1809. ------------------------------------------------------------------------
  1810. @NODE ARvarious
  1811. @TITLE "Various"
  1812.   @{b}Command:@{ub}
  1813.     Filter @{i}State@{ui}
  1814.   @{b}Description:@{ub}
  1815.     Turn on or off the filter. 1 means on and 0 means off.
  1816.   @{b}Input:@{ub}
  1817.     state - the filter state
  1818.   @{b}Result:@{ub}
  1819.     None
  1820.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1821.   @{b}Command:@{ub}
  1822.     Quit
  1823.   @{b}Description:@{ub}
  1824.     This will quit APlayer immediately.
  1825.   @{b}Input:@{ub}
  1826.     None
  1827.   @{b}Result:@{ub}
  1828.     None
  1829. @ENDNODE
  1830. ------------------------------------------------------------------------
  1831. @NODE ARVolume
  1832. @TITLE "Volume"
  1833.   @{b}Command:@{ub}
  1834.     vol = GetVolume
  1835.   @{b}Description:@{ub}
  1836.     Get  the  current  volume and place the result in "vol". If the current
  1837.     player can't change the volume, the result will be 64.
  1838.   @{b}Input:@{ub}
  1839.     None
  1840.   @{b}Result:@{ub}
  1841.     vol - the current volume
  1842.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1843.   @{b}Command:@{ub}
  1844.     SetVolume @{i}vol@{ui}
  1845.   @{b}Description:@{ub}
  1846.     Set the volume to "vol". If the number is out of range the volume would
  1847.     be set to either max or min.
  1848.   @{b}Input:@{ub}
  1849.     vol - the new volume
  1850.   @{b}Result:@{ub}
  1851.     None
  1852.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1853.   @{b}Command:@{ub}
  1854.     vol = VolumeDown
  1855.   @{b}Description:@{ub}
  1856.     Move the volume one tick down. It will return the new volume.
  1857.   @{b}Input:@{ub}
  1858.     None
  1859.   @{b}Result:@{ub}
  1860.     vol - the new volume
  1861.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1862.   @{b}Command:@{ub}
  1863.     vol = VolumeUp
  1864.   @{b}Description:@{ub}
  1865.     Move the volume one tick up. It will return the new volume.
  1866.   @{b}Input:@{ub}
  1867.     None
  1868.   @{b}Result:@{ub}
  1869.     vol - the new volume
  1870. @ENDNODE
  1871. ------------------------------------------------------------------------
  1872. @NODE ARWind
  1873. @TITLE "Wind"
  1874.   @{b}Command:@{ub}
  1875.     Forward
  1876.   @{b}Description:@{ub}
  1877.     Step one pattern forward. The same as pressing the forward button.
  1878.   @{b}Input:@{ub}
  1879.     None
  1880.   @{b}Result:@{ub}
  1881.     None
  1882.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1883.   @{b}Command:@{ub}
  1884.     Rewind
  1885.   @{b}Description:@{ub}
  1886.     Step one pattern backward. The same as pressing the rewind button.
  1887.   @{b}Input:@{ub}
  1888.     None
  1889.   @{b}Result:@{ub}
  1890.     None
  1891. @ENDNODE
  1892. ------------------------------------------------------------------------
  1893. @NODE ARWindow
  1894. @TITLE "Window"
  1895.   @{b}Command:@{ub}
  1896.     Iconify
  1897.   @{b}Description:@{ub}
  1898.     Iconify APlayer with an AppIcon.
  1899.   @{b}Input:@{ub}
  1900.     None
  1901.   @{b}Result:@{ub}
  1902.     None
  1903.  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  1904.   @{b}Command:@{ub}
  1905.     Popup
  1906.   @{b}Description:@{ub}
  1907.     Popup the main window.
  1908.   @{b}Input:@{ub}
  1909.     None
  1910.   @{b}Result:@{ub}
  1911.     None
  1912. @ENDNODE
  1913. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  1914. @Node cfg
  1915. @TITLE "Configuration Window"
  1916.  _________________________________________________________________________
  1917. |  ______________________________________________________________________ |
  1918. | |o|                      @{" Configuration Cycle " LINK cfgMaincycle}                       | |
  1919. |                                                                         |
  1920. |                         - Here you change many -                        |
  1921. |                          - different options. -                         |
  1922. |                                                                         |
  1923. |                              - To see how -                             |
  1924. |                        - press the button above -                       |
  1925. |                                                                         |
  1926. |                                                                         |
  1927. |                                                                 @{"x/x < >" LINK cfgPages}|
  1928. | @{" Players " LINK cfgPlayers}                  @{" Noteplayers " LINK cfgplayers}                     @{" Agents " LINK cfgplayers}|
  1929. |                                                                         |
  1930. | @{"  Save   " LINK cfgsaveusecancel}                  @{"     Use     " LINK cfgsaveusecancel}                     @{" Cancel " LINK cfgsaveusecancel}|
  1931. |_________________________________________________________________________|
  1932.  Click @{"here" LINK prefsmenu} to see how to use the menus in this window.
  1933. @ENDNODE
  1934. -------------------------------------------------------------------------------
  1935. @NODE cfgMaincycle
  1936. @TITLE "Main Configuration Cycle"
  1937.   @{"Options" LINK cfgOptions}  @{" 2 " LINK cfgoptions2} : Set and toggle several options.
  1938.   @{" Paths " LINK cfgPaths} : Here you can decide where from APlayer should get it's files.
  1939.   @{"Hotkeys" LINK cfgHotkeys} : Change the hotkey definitions of APlayer.
  1940.   @{" ARexx " LINK cfgARexx} : Configure the ARexx part of APlayer.
  1941.   @{"Windows/Screens" LINK cfgwindowsscreens} : Change Aplayers positions and layout.
  1942.   @{"Unpack" LINK cfgUnpack} : Which packers/archivers should APlayer recognize ?
  1943. @ENDNODE
  1944. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  1945. @NODE cfgOptions
  1946. @TITLE "Configurations Options"
  1947.   @{b}Options Configuration page @{i}1 @{ui}:@{ub}
  1948.   ________________________________________________________________________
  1949.  |                                                                        |
  1950.  |  @{"  " LINK Loadlibraries} @{u}L@{uu}oad Libraries     @{"\/" LINK Expungelibraries} E@{u}x@{uu}punge Libraries       @{"\/" LINK tipoftheday} T@{u}i@{uu}p of the Day |
  1951.  |                                                                        |
  1952.  |  @{"\/" LINK AllocateChannels} All@{u}o@{uu}cate Channels  @{"  " LINK Jumptoaddedmodule} @{u}J@{uu}ump To Loaded Module   @{"\/" LINK OnlineHelp} Online @{u}H@{uu}elp    |
  1953.  |                                                                        |
  1954.  |  @{"  " LINK VBlankInterrupt} @{u}V@{uu}Blank Interrupt   @{"  " LINK forcefilteroff} Force @{u}F@{uu}ilter Off                           |
  1955.  |________________________________________________________________________|
  1956.  |                                                                        |
  1957.  |  @{"  " LINK Doublebuffering} @{u}D@{uu}ouble Buffering     Early Load: @{"ooo                           " LINK earlyload} 1|
  1958.  |________________________________________________________________________|
  1959.  |                                                                        |
  1960.  |  @{"  " LINK FademoduleAtEnd} Fade @{u}M@{uu}odule At End                         @{"  " LINK FadeAtPause} Fade At Pause/Nex@{u}t@{uu} |
  1961.  |                                                                        |
  1962.  |  Fade Speed: @{"oooooooooo                                             " LINK FadeSpeed} 1|
  1963.  |________________________________________________________________________|
  1964.  |                                                                        |
  1965.  |                E@{u}r@{uu}ror Messages: @{"     All     " LINK Errormessages}                  1/2 < @{">" LINK cfgoptions2}|
  1966.  |________________________________________________________________________|
  1967. @ENDNODE
  1968. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  1969. @Node LoadLibraries
  1970. @TITLE "Load Libraries"
  1971.   @{u}@{b}Load Libraries:@{ub}@{uu}
  1972.   This gadget will cause APlayer  to load the selected  unpack library, all
  1973.   noteplayers,  agents  and   all  the  player  libraries, defined  in  the
  1974.   @{"player-configuration" LINK cfgplayers}, the  first  time APlayer is  started. This  will of
  1975.   course use more memory, but  it will  also  give  faster  access  to  all
  1976.   player libraries which means quicker moduleload.
  1977.   It can also come in handy for people without harddisk, because loading of
  1978.   all  player  libraries  at  start  avoids  a  lot  of diskswapping during
  1979.   module-load.
  1980. @{b}  Default is OFF.@{ub}
  1981. @ENDNODE
  1982. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  1983. @Node AllocateChannels
  1984. @TITLE "Allocate Channels"
  1985.   @{u}@{b}Allocate Channels:@{ub}@{uu}
  1986.   With this gadget ON you can prevent other music programs from interfering
  1987.   with  the  audiochannels.  If you change  the  state  of  this gadget the 
  1988.   channels will be (de)allocated when the next module is loaded.
  1989.   That is, the  channels will  always be  allocated as  long as there  is a
  1990.   module in memory.
  1991. @{b}  Default is ON.@{ub}
  1992. @ENDNODE
  1993. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  1994. @Node VBlankInterrupt
  1995. @TITLE "VBlank Interrupt"
  1996.   @{u}@{b}VBlank Interrupt:@{ub}@{uu}
  1997.   This gadget is used to help people who's  still  using  SoundTracker  and
  1998.   NoiseTracker  modules,  containing  VBlank speed commands bigger than 1F.
  1999.   These can under normal conditions sound to slow, played by  this  player.
  2000.   But  checking  this  gadget, will cause the player to interpret all speed
  2001.   commands in the module as VBlank speed commands, which will  correct  the
  2002.   speed errors.
  2003. @{b}  Default is OFF.@{ub}
  2004. @ENDNODE
  2005. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2006. @Node ExpungeLibraries
  2007. @TITLE "Expunge Libraries"
  2008.   @{u}@{b}Expunge Libraries:@{ub}@{uu}
  2009.   With this checkmark you can decide wether  the  memory  used  by  already
  2010.   loaded libraries  should  be  released or not, when you quit the program.
  2011.   If you often quit and reload the APlayer, then this button will help you.
  2012.   As  it  will  prevent the player libraries, agents  and noteplayers  from
  2013.   being  loaded everytime  you restart  the player  and load a  new kind of
  2014.   module.
  2015.   Because most people want  to  have  as  much  memory  as  possible,  this
  2016.   function is by default set to ON.
  2017. @{b}  Default is ON.@{ub}
  2018. @ENDNODE
  2019. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2020. @Node Jumptoaddedmodule
  2021. @TITLE "Jump To added Module"
  2022.   @{u}@{b}Jump To Loaded Module:@{ub}@{uu}
  2023.   If there  are  modules already  in the modulelist and you press the  PLAY
  2024.   button, and select a number of files, they will automatically be added to
  2025.   the end of the list. With this function set to ON, APlayer will be forced
  2026.   to load and play the first selected module (in the filerequester).
  2027. @{b}  Default is OFF.@{ub}
  2028. @ENDNODE
  2029. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2030. @Node ForceFilteroff
  2031. @TITLE "Force Filter Off"
  2032.   @{u}@{b}Force Filter Off:@{ub}@{uu}
  2033.   This will force APlayer to keep  the  audiofilter  turned  off.  This  is
  2034.   useful  for  old  noisetracker modules which used one command to turn the
  2035.   filter on/off instead of the new protracker which uses two  different  to
  2036.   do so.
  2037. @{b}  Default is OFF.@{ub}
  2038.   @{b}NOTE: This function is not supported by all moduletypes. See @{"module types" LINK modtypes}.@{ub} 
  2039. @ENDNODE
  2040. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2041. @Node Tipoftheday
  2042. @TITLE "Tip of The Day"
  2043.   @{u}@{b}Tip of The Day:@{uu}@{ub}
  2044.   This option, if on, will make APlayer open a window every time it  starts
  2045.   up.  The  window  will  display  a  randomly  selected hint on the use of
  2046.   APlayer, to help you use APlayer's many functions to their full extent.
  2047. @ENDNODE
  2048. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2049. @NODE OnlineHelp
  2050. @TITLE "Online Help"
  2051.   @{u}@{b}Online Help:@{uu}@{ub}
  2052.   Online Help in APlayer is only a Help-click away with this turned on :)
  2053.   Place the  mouse pointer on the  thing (Gadget, list, whatever) and press
  2054.   the HELP-key.
  2055.   Remember that to show the online help, APlayer needs the APlayer.guide to
  2056.   be  in  "progdir:docs/APlayer.guide" That is, it has to be in a directory
  2057.   placed along with APlayer called "docs".
  2058.   If you have used the APlayer installer to install the program, everything
  2059.   should be placed correctly and you won't have to worry about it.
  2060. @ENDNODE
  2061. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2062. @Node DoubleBuffering
  2063. @TITLE "Double Buffering"
  2064.   @{u}@{b}Double Buffering:@{ub}@{uu}
  2065.   This function will cause the APlayer to load the next module in the list,
  2066.   while  the  current  module  still  plays. This will normally prevent the
  2067.   silence between two modules. If you don't check this one, you  will  save
  2068.   some  ram, but you will have to wait in silence for the next module to be
  2069.   loaded and started.
  2070.   See also @{"Early Load" LINK earlyload} for more info on this.
  2071. @{b}  Default is OFF.@{ub}
  2072. @ENDNODE
  2073. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2074. @NODE EarlyLoad
  2075. @TITLE "Early Load"
  2076.   @{b}Early Load:@{ub} This  slider is used in conjuction with the @{"double buffering" LINK Doublebuffering}
  2077.               function.   The  value  (1-9)  indicates  how  many  patterns
  2078.               (positions) before the module ends, the next module should be
  2079.               loaded. For harddisk users a value of 1 is enough, but if you
  2080.               use a diskdrive, you will have to set it to 3 or 4, dependent
  2081.               of the modulesizes.
  2082. @ENDNODE
  2083. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2084. @Node FademoduleatEnd
  2085. @TITLE "Fade Module At End"
  2086.   @{u}@{b}Fade Module At End:@{ub}@{uu}
  2087.   This flag will cause the player to automatically fade the module at end.
  2088.   See also @{"Fade Speed" LINK fadespeed}.
  2089. @{b}  Default is OFF.@{ub}
  2090.   @{b}NOTE: This function isn't supported by all moduletypes. See @{"module types" LINK modtypes}.@{ub}
  2091. @ENDNODE
  2092. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2093. @Node FadeatPause
  2094. @TITLE "Fade At Pause/Next"
  2095.   @{u}@{b}Fade At Pause/Next:@{ub}@{uu}
  2096.   This flag will cause the player to automatically fade the module when the
  2097.   user  hits  the  "next module"- or the "pause"-gadget in the main window.
  2098.   Note that releasing the "pause" button again  will  fade  up  the  volume
  2099.   again.
  2100. @{b}  Default is OFF.@{ub}
  2101.   @{b}NOTE: This function is not supported by all moduletypes. See @{"module types" LINK modtypes}.@{ub} 
  2102. @ENDNODE
  2103. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2104. @Node FadeSpeed
  2105. @TITLE "Fade Speed"
  2106.   @{b}Fade Speed:@{ub} Use  this  slider  to  choose how fast the fading of a module
  2107.               should  be.  1 is the fastest and 4 is the slowest. Note that
  2108.               this will only affect the @{"Fade Module At End" LINK fademoduleatend}.
  2109. @ENDNODE
  2110. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2111. @Node ErrorMessages
  2112. @TITLE "Error Messages"
  2113.   @{u}@{b}Error Requesters:@{ub}@{uu}
  2114.   With this selector you can choose which error messages you want to see.
  2115.   @{b}All@{ub}     : Both APlayer and Dos errors.
  2116.   @{b}APlayer@{ub} : Unknown  moduletype, out of mem, decrunch  error, couldn't find
  2117.             Arexx, Channel allocation error aso.
  2118.   @{b}Dos@{ub}     : read/write error, file not found etc
  2119.   @{b}None@{ub}    : None of the above
  2120.   The Dos-errors will always delete the module from the list  (no  use  for
  2121.   crap files in the list, or..).
  2122.   If you choose not to see the APlayer errors, APlayer  will  usually  just
  2123.   skip the module, instead of deleting it from the list.
  2124. @ENDNODE
  2125. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2126. @NODE cfgoptions2
  2127. @TITLE "Configuration Options Page 2"
  2128.   @{b}Options Configuration page @{i}2 @{ui}:@{ub}
  2129.   ________________________________________________________________________
  2130.  |                   ___________________________________________________  |
  2131.  |    @{"Cut Prefixes" LINK cutprefixes}:|@{u}mod.|mdat.@{uu}_________________________________________| |
  2132.  |                   ___________________________________________________  |
  2133.  |  @{"Module Pattern" LINK Modulepattern}:|@{u}~(SMPL.#?|#?.nt|#?.ins)@{uu}____________________________| |
  2134.  |                   ________________________________________________     |
  2135.  |        @{"App Icon" LINK cfgAppIcon}:|________________________________________________| @{"o" LINK Disk} |
  2136.  |________________________________________________________________________|
  2137.  |                                                                        |
  2138.  | @{"  " LINK Timeout} Ne@{u}v@{uu}er Ending Module Timeout: @{" 120" LINK Timeoutvalue} seconds                         |
  2139.  |                                                                        |
  2140.  | At @{u}E@{uu}nd of Modulelist: @{"@|           Jump to start             " LINK endmodulelist} 2/2 @{"<" LINK cfgoptions} >|
  2141.  |________________________________________________________________________|
  2142. @ENDNODE
  2143. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2144. @NODE CutPrefixes
  2145. @TITLE "Cut Prefixes"
  2146.   @{b}Cut Prefixes:@{ub}
  2147.    As  you  have  maybe  noticed, there  isn't  much  space  left  for  the
  2148.    modulenames in the main window. This is because most moduletypes usually
  2149.    are  classified  by a file prefix,  e.g. "mod."  This string  is used to
  2150.    define  which prefixes  APlayer should cut  automatically from the list.
  2151.    The format is like this: Prefix1|Prefix2|Prefix3  etc. (notice  the  "|"
  2152.    (pipe) between the different prefixes!)
  2153.    If you don't want anything to be left out, just leave this string empty.
  2154. @ENDNODE
  2155. --------------------------------------------------------------------------------
  2156. @NODE Modulepattern
  2157. @TITLE "ModulePattern"
  2158.   @{b}@{u}Module Pattern:@{ub}@{uu}
  2159.    Here you can define the filepattern in the filerequester when  you  load
  2160.    modules.  Default is ~(SMPL.#?|#?.nt|#?.ins) which means that all files,
  2161.    except files  starting with "smpl.", ending  with ".nt" or ".ins" should
  2162.    be displayed.
  2163. @ENDNODE
  2164. ---------------------------------------------------------------------------------
  2165. @NODE cfgAppIcon
  2166. @TITLE "AppIcon"
  2167.   @{u}@{b}Configure App-Icon:@{ub}@{uu}
  2168.   If you don't like the supplied @{"app-icon" LINK app-icon}(sheep power :) then you can pick
  2169.   an icon of your own to be used as APlayers App-icon.
  2170.   If the specified icon file cannot be found, APlayer will be forced to use
  2171.   @{b}sheep@{ub} power though :)
  2172.   @{b}NOTE: If  you  don't  have  the  Newicons  patch  installed  DO  NOT!,  I
  2173.         repeat,  DO NOT USE A NEWICON AS AN APPICON, IT WILL MAKE WORKBENCH
  2174.         CRASH. (At best :)@{ub}
  2175. @ENDNODE
  2176. ---------------------------------------------------------------------------------
  2177. @NODE Timeout
  2178. @TITLE "Never Ending Module Timeout"
  2179.   @{b}@{u}Never Ending Module Timeout:@{uu}@{ub}
  2180.   Selecting this will cause APlayer  to  automatically  skip  to  the  next
  2181.   module  after the given number of @{"seconds" LINK timeoutvalue}, if the module doesn't support
  2182.   @{"positions" LINK modtypes}.
  2183. @ENDNODE
  2184. ---------------------------------------------------------------------------------
  2185. @NODE timeoutvalue
  2186. @TITLE "Never Ending Module Timeout Value"
  2187.   @{b}@{u}Timeout Value:@{uu}@{ub}
  2188.   Here you can specify how many seconds the module should be played, before
  2189.   APlayer skips to the next module.
  2190.   Values from 1 to 9999 seconds (02hr, 46min and 39secs) is supported.
  2191. @ENDNODE
  2192. ---------------------------------------------------------------------------------
  2193. @NODE EndModulelist
  2194. @TITLE "What to do at end of modulelist""
  2195.   @{b}@{u}End of Modulelist:@{uu}@{ub}
  2196.   When APlayer reaches the bottom of the module  list,  that  is  when  the
  2197.   module  is  finished,  you  can choose between three actions, what should
  2198.   happen:
  2199.  Jump to start : Will start to play the modulelist over again. (default)
  2200.  Loop module   : Will loop the last module in the list over and over ..
  2201.  Eject module  : Ejects the played module from memory.
  2202. @ENDNODE
  2203. ---------------------------------------------------------------------------------
  2204. @NODE cfgPaths
  2205. @TITLE "Paths Configuration"
  2206.  @{u}@{b}Paths Configuration:@{uu}@{ub}
  2207.   ________________________________________________________________________
  2208.  |                   ________________________________________________     |
  2209.  | @{"Start Scan Path" LINK startscanpath}:|________________________________________________| @{"o" LINK disk} |
  2210.  |                   ________________________________________________     |
  2211.  |     @{"Module Path" LINK modulepath}:|________________________________________________| @{"o" LINK disk} |
  2212.  |                   ________________________________________________     |
  2213.  |       @{"APML Path" LINK APMLpath}:|@{u}S:@{uu}______________________________________________| @{"o" LINK disk} |
  2214.  |                   ________________________________________________     |
  2215.  |       @{"Temp Path" LINK Temppath}:|@{u}T:@{uu}______________________________________________| @{"o" LINK disk} |
  2216.  |________________________________________________________________________|
  2217. @ENDNODE
  2218. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2219. @NODE startscanpath
  2220. @TITLE "Start Scan Path"
  2221.   @{b}Start Scan Path:@{ub}
  2222.    In this string you may specify a directory, which  will be  scanned  for
  2223.    modules  when  you start the APlayer. The modules will be shuffled and a
  2224.    random module will be chosen and played.  This will of course also cause
  2225.    lha  archives  to be unarchived. If you don't want this to happen, leave
  2226.    this string empty.
  2227. @ENDNODE
  2228. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2229. @NODE modulepath
  2230. @TITLE "Module Path"
  2231.   @{b}Module Path:@{ub}
  2232.    This tells APlayer where you want it to look for your modules.  You  can
  2233.    use  the  diskgadget  to  the  right  to  choose  the  modulepath from a
  2234.    file-requester.
  2235. @ENDNODE
  2236. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2237. @NODE APMLpath
  2238. @TITLE "APML Path"
  2239.   @{b}APML Path:@{ub}
  2240.    This tells APlayer where you keep your modulelist files. You can use the
  2241.    diskgadget  to the right to choose the modulepath from a file-requester.
  2242.    Default is S:
  2243. @ENDNODE
  2244. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2245. @NODE Temppath
  2246. @TITLE Temp Path"
  2247.   @{b}Temp Path:@{ub} 
  2248.    This is the path which APlayer will use to unpack crunched  files, store
  2249.    lha files  and so on. You can use the  diskgadget to the right to choose
  2250.    choose the modulepath from a file-requester. Default is T:
  2251. @ENDNODE
  2252. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2253. @NODE cfgHotkeys
  2254. @TITLE "Hotkeys Configuration"
  2255.   ________________________________________________________________________
  2256.  |                         ______________________________________________ |
  2257.  | @{"App Popup/Hide Hotkey" LINK apppopup}:|@{u}control shift a@{uu}_______________________________||
  2258.  |                         ______________________________________________ |
  2259.  |     @{"Popup/Hide Hotkey" LINK popuphide}:|@{u}control alt a@{uu}_________________________________||
  2260.  |                         ______________________________________________ |
  2261.  | @{"Hotkey To Skip Module" LINK skiphotkey}:|@{u}control alt space@{uu}_____________________________||
  2262.  |________________________________________________________________________|
  2263.  |                                                                        |
  2264.  |         @{"Config" LINK hotkeyconfiglist}                   @{"Show" LINK hotkeyshowlist}                @{"Used Hotkeys" LINK usedhotkeyslist}   |
  2265.  ||                      ||                      ||                      ||
  2266.  ||                      ||                      ||                      ||
  2267.  ||                      ||                      ||                      ||
  2268.  ||______________________||______________________||______________________||
  2269.  |                            __________________________________          |
  2270.  | @{"  Update Lists  " LINK updatelists} @{"Hotkey" LINK hotkey}:|                                  | 1/1 < > |
  2271.  |                            
  2272.           |
  2273. @ENDNODE
  2274. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2275. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2276. @Node apppopup
  2277. @TITLE "Configuration - App Popup/Hide Hotkey"
  2278.   @{b}App Popup/Hide Hotkey:@{ub}
  2279.   This string contains the hotkey for the  APlayer  Program.  Pressing  the
  2280.   defined hotkey will close all open APlayer windows, and popup an app-icon
  2281.   on the workbench. See @{"app-icon" link app-icon}.
  2282.   @{b}NOTE: Any valid commodity hotkey can be used for these hotkeys.@{ub}
  2283. @ENDNODE
  2284. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2285. @NODE popuphide
  2286. @TITLE "Configuration - Popup/Hide Hotkey"
  2287.   @{b}Popup/Hide Hotkey:@{ub}
  2288.   This is  nearly exactly the same as the "App Popup/Hide" hotkey, but this
  2289.   will NOT popup an app-icon on workbench. See @{"app-icon" link app-icon}.
  2290.   @{b}NOTE: Any valid commodity hotkey can be used for these hotkeys.@{ub}
  2291. @ENDNODE
  2292. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2293. @NODE skiphotkey
  2294. @TITLE "Configuration - Hotkey To Skip Module"
  2295.   @{b}Hotkey To Skip Module:@{ub}
  2296.   Pressing the defined hotkey will  be  the  same  as  pressing  the  "next
  2297.   module" gadget in the main window.
  2298.   @{b}NOTE: Any valid commodity hotkey can be used for these hotkeys.@{ub}
  2299. @ENDNODE
  2300. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2301. @NODE hotkeyconfiglist
  2302. @TITLE "Configuration Hotkeys"
  2303.   @{b}Config:@{ub}
  2304.   This list displays all players,  noteplayers  and  agents  which  have  a
  2305.   configuration  window assigned  to them. Pressing one of the entries will
  2306.   allow you to change the @{"hotkey" LINK hotkey} for the chosen item.
  2307.   Defining a hotkey for i.e. a player config will allow you to  access  and
  2308.   change  the  configuration  for the given player at any time, so that you
  2309.   won't have to enter the  APlayer  configuration  everytime  you  want  to
  2310.   change something.
  2311. @ENDNODE
  2312. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2313. @NODE hotkeyshowlist
  2314. @TITLE "Show Hotkeys"
  2315.   @{b}Show:@{ub}
  2316.   This list displays all players, noteplayers and agents which have a  show
  2317.   window  assigned to  them. Pressing  one of the entries will allow you to
  2318.   change the @{"hotkey" LINK hotkey} for the chosen item.
  2319.   Defining a hotkey for i.e. an Agents show window will allow you make  the
  2320.   agent appear everytime you press the defined hotkey.
  2321. @ENDNODE
  2322. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2323. @NODE usedhotkeyslist
  2324. @TITLE "Used Hotkeys"
  2325.   @{b}Used Hotkeys@{ub}
  2326.   This is a list of all used hotkeys. Simple but that's right :)
  2327.   APlayer will automically check if you have used the  same  hotkey  twice,
  2328.   but  only  if they are spelt the same way. That is, "control a" and "ctrl
  2329.   a" will not be the same hotkey to APlayer. If you  have  two  identically
  2330.   hotkeys  then the player, noteplayer or agent which is displayed first in
  2331.   the list, will be activated.
  2332. @ENDNODE
  2333. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2334. @NODE Updatelists
  2335. @TITLE "Update Lists"
  2336.   @{b}Update Lists:@{ub}
  2337.   When you press this button all player libraries, noteplayers  and  agents
  2338.   will be scanned  to see if they have a config  or a show window, and then
  2339.   which hotkeys they eventually uses.
  2340.   All the information will then be printed in the three lists above.
  2341. @ENDNODE
  2342. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2343. @NODE Hotkey
  2344. @TITLE "Hotkey Definition"
  2345.   @{b}Hotkey:@{ub}
  2346.   This is where you describe the hotkey for the chosen  player,  noteplayer
  2347.   or agent. The hotkey can be any legal commodity hotkey.
  2348. @ENDNODE
  2349. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2350. @NODE cfgARexx
  2351. @TITLE "ARexx Configuration"
  2352.   ________________________________________________________________________
  2353.  | @{"  " LINK ActivateArexx} Activate ARex@{u}x@{uu}                                            @{" Clear " LINK ARexxClear} |
  2354.  | @{"@|                                SHIFT                              " LINK ARexxcycle} |
  2355.  |      ___________________________           _________________________   |
  2356.  | @{"F1" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F6" LINK F1} |_________________________|@{"o" LINK DISK}|
  2357.  |      ___________________________           _________________________   |
  2358.  | @{"F2" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F7" LINK F1} |_________________________|@{"o" LINK DISK}|
  2359.  |      ___________________________           _________________________   |
  2360.  | @{"F3" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F8" LINK F1} |_________________________|@{"o" LINK DISK}|
  2361.  |      ___________________________           _________________________   |
  2362.  | @{"F4" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F9" LINK F1} |_________________________|@{"o" LINK DISK}|
  2363.  |      ___________________________           _________________________   |
  2364.  | @{"F5" LINK F1} |___________________________|@{"o" LINK DISK}   @{"F0" LINK F1} |_________________________|@{"o" LINK DISK}|
  2365.  |                                                                        |
  2366.  |________________________________________________________________________|
  2367. @ENDNODE
  2368. -------------------------------------------------------------------------------
  2369. @NODE ActivateARexx
  2370. @TITLE "Activate ARexx"
  2371.   @{b}Activate ARexx:@{ub} This  will  cause  APlayer to  open an  ARexx port  named
  2372.                   APLAYER, through which you can speak with APlayer.
  2373.                   To get more info on the APlayer ARexx commands see @{"here" LINK ARexxMain}.
  2374. @ENDNODE
  2375. -------------------------------------------------------------------------------
  2376. @NODE F1
  2377. @TITLE "ARexx Macros"
  2378.   @{b} F1-F10@{ub}: In these strings you can define  which Arexx macros to execute
  2379.            when the actual key is pressed.
  2380.            Remember that the qualifier  which is used in conjunction with
  2381.            the  key  is  set  using  the @{"cyclegadget" LINK ARexxCycle}. If your
  2382.            macros  aren't  in REXX: then you have to write the full path.
  2383.            This  can  be  done  easily  by pressing the diskgadget to the
  2384.            right of each stringgadget.
  2385.   @{i}Note: It  is not allowed  to have spaces in filenames or paths. This is
  2386.         due to an "error" in Arexx, not in APlayer.@{ui}
  2387. @ENDNODE
  2388. -------------------------------------------------------------------------------
  2389. @NODE ARexxCycle
  2390. @TITLE "ARexx Qualifier"
  2391.   @{b} Cycle@{ub}: With this you select 3 different states:
  2392.         @{b}Shift or Alt@{ub}: This position contains the names of the macros  to
  2393.                       be  executed   when  you  have  shift/alt  pressed
  2394.                       together with @{"F1-F10" LINK F1}.
  2395.        
  2396.         @{b}Other@{ub}: Changes the names of the strings to the following:
  2397.                @{b}ST@{ub}: (STart) The macro to be  executed when APlayer starts.
  2398.                    Note this is the last thing which is done when APlayer
  2399.                    starts.
  2400.                @{b}ED@{ub}: (EnD) This macro will be executed when you try to quit
  2401.                    APlayer. Note that the only way APlayer can exit then,
  2402.                    is by sending a "quit" commando to the Arexx port.
  2403.                @{b}PB@{ub}: (PlayButton) This macro is executed when you press the
  2404.                    playbutton. Note that it'll  prevent the filerequester
  2405.                    from  appearing, which enables  you  to make  your own
  2406.                    moduleselector via Arexx.
  2407.                @{b}PL@{ub}: (PLay) This  macro is  executed when a module has been
  2408.                    successfully recognized and loaded.
  2409. @ENDNODE
  2410. -------------------------------------------------------------------------------
  2411. @NODE ARexxClear
  2412.   @{b}Clear@{ub}: This will clear all macro settings. Note that it will ask you to
  2413.          confirm your choice first.
  2414. @ENDNODE
  2415. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2416. @NODE cfgwindowsscreens
  2417. @TITLE "Configuration - Windows/Screens"
  2418.   ________________________________________________________________________
  2419.  |                     @{"Screens" LINK Screens}                                           |
  2420. | @{"  " LINK defaultscreen} Default Screen       |
  2421.  ||                                            |                          |
  2422.  ||                                            | @{"Save Window Positions" LINK savewindowpositions}   |
  2423.  ||                                            |                          |
  2424.  ||                                            |                          |
  2425.  ||                                            |                          |
  2426.  ||                                            |                          |
  2427.  ||____________________________________________|                          |
  2428.  |________________________________________________________________________|
  2429.  |                     _______________________________________            |
  2430.  |         @{"List Font" LINK listfont} |@{u}topaz.8@{uu}________________________________| @{"o" LINK DISK}        |
  2431.  |                     _______________________________________            |
  2432.  |      @{"General Font" LINK generalfont} |topaz.8                                | @{"o" LINK DISK} 1/1 < >|
  2433.  |                     
  2434.             |
  2435. @ENDNODE
  2436. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2437. @NODE Screens
  2438. @TITLE "Screen List"
  2439.   @{b}Screen List:@{ub}
  2440.   This is a list of all available public screens at the moment.  From  this
  2441.   list  you  can  choose on which screen you will like APlayer to be opened
  2442.   on. If you double click one of the screen names, APlayer  will  instantly
  2443.   jump to  that screen. The screen choice can of course still  be cancelled
  2444.   with the configuration @{"cancel" LINK cfgsaveusecancel} button.
  2445. @ENDNODE
  2446. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2447. @NODE Defaultscreen
  2448. @TITLE "Default Screen"
  2449.  @{b}Default Screen@{ub}
  2450.  Setting this flag will cause APlayer always to open on the default  public
  2451.  screen, instead of the one chosen from the @{"Screens" LINK screens} list.
  2452. @ENDNODE
  2453. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2454. @NODE Savewindowpositions
  2455. @TITLE "Save Window Positions"
  2456.   @{b}Save Window Positions:@{ub}
  2457.   To use this button do the following:
  2458.   1. Place all  the APlayer  windows exactly where  you want  them and size
  2459.      them  as you  like. You can close  a window when you  have placed  and
  2460.      sized it since the position and size will be remembered anyway.
  2461.   2. Press this button
  2462.   3. All window  positions and  sizes will now be  saved  in a  file called
  2463.      APlayer.win
  2464.   @{b}NOTE 1:@{ub} This is a kind snapshot function,  and  if  you  don't  like  the
  2465.   snapshot,  and you don't want to change the window positions, you have to
  2466.   manually delete the APlayer.win file from the ENVARC:APlayer/ directory.
  2467.   @{b}Note 2:@{ub} If you try to open a window with coordinates which  are  too  big
  2468.   for the actual screen, then the windowposition and size will be fitted to
  2469.   the screen if possible, else it will not be opened.
  2470. @ENDNODE
  2471. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2472. @NODE Listfont
  2473. @TITLE "List Font"
  2474.   @{b}List Font:@{ub}
  2475.   The font defined here will appear in all APlayer lists. The font can have
  2476.   a max size of 24.
  2477. @ENDNODE
  2478. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2479. @NODE GeneralFont
  2480. @TITLE "General Font"
  2481.   @{b}General Font:@{ub}
  2482.   The general  font is used in all gadgets, strings, yes nearly everywhere,
  2483.   except @{"lists" LINK listfont}.
  2484.   @{b}NOTE:@{ub} Since APlayers front-end isn't font sensitive, it is not adviseable
  2485.   to choose a font bigger  than 8 points, if you still want APlayer to look
  2486.   good :)
  2487. @ENDNODE
  2488. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2489. @NODE cfgunpack
  2490. @TITLE "Configuration - Unpack"
  2491.   ________________________________________________________________________
  2492.  |                                                                        |
  2493.  |              @{"Path" LINK Unpackpath}             @{"Arguments" LINK Unpackarguments}          @{"Check Pattern" LINK checkpattern}      |
  2494.  |     _______________________  _______________   _______________________ |
  2495.  | @{"  " LINK unpacklha}|LHA                    ||e "%s"         | |(#?.lha|#?.lzh)        ||
  2496.  |     
  2497.  |     _______________________  _______________   _______________________ |
  2498.  | @{"  " LINK unpacklzx}|LZX                    ||x "%s"         | |#?.lzx                 ||
  2499.  |     
  2500.  |________________________________________________________________________|
  2501.  |                        ______________________________________________  |
  2502.  |      @{"Extract Pattern" LINK extractpattern}:|@{u}#?@{uu}____________________________________________| |
  2503.  |________________________________________________________________________|
  2504.  |                       _______________________________________          |
  2505.  |      @{"Unpack Library" LINK unpacklibrary}: @|                None                 | 1/1 < > |
  2506.  |                       
  2507.           |
  2508. @ENDNODE
  2509. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2510. @NODE Unpackpath
  2511. @TITLE "Unpack Path"
  2512.   @{b}Unpack Path:@{ub}
  2513.   Here you tell APlayer where you have your lha extractor. Per default both
  2514.   lha  and  lzx  should  be in the path, so if you for instance have lha as
  2515.   dh0:archivers/lha you should write in the lha path field.
  2516. @ENDNODE
  2517. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2518. @NODE Unpackarguments
  2519. @TITLE "Unpack Arguments"
  2520.   @{b}Unpack Arguments:@{ub}
  2521.   This is the arguments which APlayer passes on to the archiver. Most users
  2522.   won't  have  to  alter  these  arguments,  but perhaps you have a special
  2523.   unarchiver which needs special arguments then you can write them here.
  2524. @ENDNODE
  2525. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2526. @NODE checkpattern
  2527. @TITLE "Unpack Check Pattern"
  2528.   @{b}Check Pattern:@{ub}
  2529.   Here you can tell APlayer how it should recognize archives. Archives will
  2530.   only  be  recognized by their filename, so you can type a filepattern for
  2531.   every archiver here.
  2532.   For instance the default lha checkpattern is (#?.lha|#?.lzh) which  means
  2533.   that every file ending with either ".lha" or ".lzh" will be recognized as
  2534.   a lha archive.
  2535. @ENDNODE
  2536. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2537. @NODE unpacklha
  2538. @TITLE "Unpack Lha"
  2539.   @{b}Unpack Lha@{ub}
  2540.   This simply tells APlayer wether to check files to see if  they  are  lha
  2541.   archives or not.
  2542. @ENDNODE
  2543. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2544. @NODE unpacklzx
  2545. @TITLE "Unpack Lzx"
  2546.   @{b}Unpack Lzx@{ub}
  2547.   This simply tells APlayer wether to check files to see if  they  are  lzx
  2548.   archives or not.
  2549. @ENDNODE
  2550. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2551. @NODE extractpattern
  2552. @TITLE "Extract Pattern"
  2553.   @{b}Extract Pattern:@{ub}
  2554.   Suppose you have a lot  of  lha  and  lzx  archives  with  both  modules,
  2555.   pictures  and  texts  (file_id.diz, .nfo-files and others). Since APlayer
  2556.   will not recognize anything else than music modules, why should  all  the
  2557.   other files get unarchived, wasting your sparesome cpu-time :)
  2558.   Therefore you can use the extract pattern to  tell  APlayer  which  files
  2559.   should be unarchived, and which shouldn't.
  2560.   If you want to get rid of certain files, you can for instance write  this
  2561.   as an extract pattern: ~(file_id.diz|#?.doc|#?.nfo|#?.txt|#?.gif)
  2562. @ENDNODE
  2563. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2564. @NODE unpacklibrary
  2565. @TITLE "Unpack Library"
  2566.   @{u}@{b}Unpack Library:@{ub}@{uu}
  2567.   This cyclegadget is used to select which library  you  want  to  use  for
  2568.   unpacking your modules. There are four possibilities:
  2569.   @{b}1. None       :@{ub} If   you  do  not  have  any  packed  modules,  use  this
  2570.                   selection.
  2571.   @{b}2. Powerpacker:@{ub} This  will  use  the  @{"powerpacker.library" LINK Thanks} to depack your
  2572.                   modules.  This  will only allow powerpacked modules to be
  2573.                   played.
  2574.   @{b}3. XPK        :@{ub} This  will  make  use of the @{"xpk-libraries" LINK Thanks} for depacking
  2575.                   your  modules. This means that it can unpack all kinds of
  2576.                   xpk-packed files including powerpacked files. Included in
  2577.                   this package is SQSH-, SMPL- and Xpkmaster-.library.
  2578.   @{b}4. Unpack     :@{ub} This  is  a  library  made  by the coder of this program,
  2579.                   which   can  recognize  and  decrunch  approximately  180
  2580.                   different  types  of  crunchers.  This  includes xpk, and
  2581.                   powerpacker.
  2582. @ENDNODE
  2583. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2584. -------------------------------------------------------------------------------
  2585. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2586. <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  2587. @NODE cfgPages
  2588. @TITLE "Sub pages"
  2589.   @{b}@{u}Sub Configuration Pages:@{uu}@{ub}
  2590.   Some of the main configuration pages uses more than  one  page.  To  look
  2591.   through the different sub-pages you can use these two arrows.
  2592.   The x/x tells the number of the actual sub-page and the total  amount  of
  2593.   sub-pages.
  2594. @ENDNODE
  2595. -------------------------------------------------------------------------------
  2596. @NODE prefsmenu
  2597. @TITLE "Preference Menu"
  2598.   @{u}@{b}Preference Menu:@{uu}@{ub}
  2599.   @{b}Project:@{ub}
  2600.    Open   : Opens a file  requester from which you  can load a new  config
  2601.             file.
  2602.    Save as: Opens  a file requester  from which you  can save  your actual
  2603.             settings.
  2604.    Quit   : This is the same as pressing cancel.
  2605.   @{b}Edit:@{ub}
  2606.    Reset To Default: This will reset the settings to the default values.
  2607.    Last Saved      : Sets your  configuration  settings to the settings of
  2608.                      the last saved configuration file.
  2609.    Restore         : The same as "Cancel", except that  it won't close the
  2610.                      window.
  2611. @ENDNODE
  2612. -------------------------------------------------------------------------------
  2613. @NODE listview
  2614. @TITLE "ListView Control"
  2615.   @{b}@{u}Listview Control:@{ub}@{uu}
  2616.   @{b}Arrow up@{ub} or @{b}down@{ub}  will move  the  highlightbar  one position up  or down.
  2617.   If no element in the list is highlighted the highlightbar will appear  at
  2618.   any cursor press.
  2619.   Using @{b}Shift@{ub} with the cursor keys, will move the list either one "page" up
  2620.   or one page down.
  2621.   Using  @{b}control@{ub} or @{b}alt@{ub} with the cursor keys  will move the highlightbar to
  2622.   either the top or the bottom.
  2623.   @{b}Return@{ub} will toggle the current (Note)player's state (enabled/disabled).
  2624. @ENDNODE
  2625. -------------------------------------------------------------------------------
  2626. @NODE DISK
  2627. @TITLE "File Requester"
  2628.  This disk button will open a @{"reqtools" LINK thanks} file requester.
  2629. @ENDNODE
  2630. -------------------------------------------------------------------------------
  2631. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2632. @NODE cfgplayers
  2633. @TITLE "Players/Noteplayers/Agents Configuration"
  2634.   @{b}@{u}Players/Noteplayers/Agents Configuration:@{ub}@{uu}
  2635.   ________________________________________________________________________
  2636.  | @{"*|            Players          " LINK plcyc} ||@{"3.13" LINK plcfgversion}  Surround-32Voices          @{"?" LINK plcfgquestionmark}|
  2637.  |                                  ||                                    |
  2638.  |                                  ||   This box contains some info      |
  2639.  |                                  ||                                    |
  2640.  |                                  ||   about the chosen player.         |
  2641.  |          @{"Player List" LINK plcfgplayerlist}            ||                                    |
  2642.  |                                  ||   Like author, technical info      |
  2643.  |                                  ||                                    |
  2644.  |                                  ||   and if it supports noteplayers.  |
  2645.  |                                  ||                                    |
  2646.  |                                  ||                                    |
  2647.  | @{" v ^ " LINK plcfgArrowupdown} @{" Config " LINK plcfgConfig} @{" Show " LINK plcfgShow} @{" Add " LINK plcfgAdd} @{" Delete " LINK plcfgDelete} @{" Exchange " LINK plcfgExchange} @{" Clear " LINK plcfgClear} @{" Sort " LINK plcfgSort} |
  2648.  |________________________________________________________________________|
  2649.  |                                                                        |
  2650.  | @{" Save " LINK plcfgsave}                        @{" Use " LINK plcfguse}                        @{" Cancel " LINK plcfgcancel} |
  2651.  |________________________________________________________________________|
  2652.   APlayer supports a lot of different module types from the SID  format  to
  2653.   Protracker. These  modules  are  played by  using  player  libraries  and
  2654.   sometimes also a noteplayer.
  2655.   Click @{"here" LINK prefsmenu} to see how to use the menus in this window.
  2656.   To move around the list you can use the @{"keyboard" LINK listview}.
  2657. @ENDNODE
  2658. <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
  2659. -------------------------------------------------------------------------------
  2660. @NODE plcfgplayerlist
  2661. @TITLE "Player/Noteplayer/Agent List"
  2662.   This list shows all available players, noteplayers and agents. To add new
  2663.   items use the add button.
  2664.   To toggle an entry in the list, you can just double-click the entry. This
  2665.   will prevent the use of the specific entry.
  2666. @ENDNODE
  2667. -------------------------------------------------------------------------------
  2668. @NODE plcfgversion
  2669. @TITLE "Version"
  2670.   Shows the version number of the chosen player, noteplayer or agent.
  2671. @ENDNODE
  2672. -------------------------------------------------------------------------------
  2673. @NODE plcfgquestionmark
  2674. @TITLE "1st Priority Noteplayer"
  2675.   This opens a list, from which you can choose the NotePlayer you prefer to
  2676.   be used with the selected player.  If you don't want  any first priority,
  2677.   just delete the name manually afterwards (you may use Amiga-X).
  2678.   If, at a later time, the selected NotePlayer  can't  be  loaded,  APlayer
  2679.   will  give  you  a requester where you can choose to stop or make APlayer
  2680.   choose a Noteplayer for you.
  2681. @ENDNODE
  2682. -------------------------------------------------------------------------------
  2683. @NODE plcfgArrowupdown
  2684. @TITLE "Item Up/Down"
  2685.   @{b}Arrow up/down:@{ub} These will move the  marked item to  either  the  position
  2686.                  above or below.
  2687.                  Pressing @{b}shift@{ub} in  conjunction  with the gadget, will move
  2688.                  the selected item to the top or the bottom of the list.
  2689. @ENDNODE
  2690. -------------------------------------------------------------------------------
  2691. @NODE plcfgConfig
  2692. @TITLE "Config"
  2693.   @{b}Config:@{ub}   Opens  a window  in which  special settings  for  the  selected
  2694.             player may be changed.
  2695. @ENDNODE
  2696. -------------------------------------------------------------------------------
  2697. @NODE plcfgShow
  2698. @TITLE "Show"
  2699.   @{b}Show:@{ub}     Will open the show window of the given Agent/Player/Noteplayer.
  2700. @ENDNODE
  2701. -------------------------------------------------------------------------------
  2702. @NODE plcfgAdd
  2703. @TITLE "Add Item"
  2704.   @{b}Add:@{ub}      Opens  a  filerequester from which you can choose the libraries
  2705.             (Agents/Players/Noteplayers) you want to add to the list.
  2706. @ENDNODE
  2707. -------------------------------------------------------------------------------
  2708. @NODE plcfgDelete
  2709. @TITLE "Delete Item"
  2710.   @{b}Delete:@{ub}   This  will  delete  the selected library from the list, but NOT
  2711.             from the disk.
  2712. @ENDNODE
  2713. -------------------------------------------------------------------------------
  2714. @NODE plcfgExchange
  2715. @TITLE "Exchange Items"
  2716.   @{b}Exchange:@{ub} Select a library, press exchange and  select another library to
  2717.             exchange the first library with.
  2718. @ENDNODE
  2719. -------------------------------------------------------------------------------
  2720. @NODE plcfgClear
  2721. @TITLE "Clear List"
  2722.   @{b}Clear:@{ub}    This will clear all the libraries except for the internals.
  2723. @ENDNODE
  2724. -------------------------------------------------------------------------------
  2725. @NODE plcfgSort
  2726. @TITLE "Sort Items"
  2727.   @{b}Sort:@{ub}     Sorts the list alphabetically.
  2728. @ENDNODE
  2729. -------------------------------------------------------------------------------
  2730. @NODE plcfgSave
  2731. @TITLE "Save Player/Noteplayer/Agent Configuration"
  2732.   @{b}Save:@{ub}     Saves   the  APlayer.libs  file   in  ENVARC:APlayer/   and  in
  2733.             ENV:APlayer/ directories. After the saving it closes the window
  2734.             and  uses  the  settings.  If  the  actual player/noteplayer is
  2735.             deleted  from  the  list and you press save, the playing module
  2736.             will be ejected.
  2737. @ENDNODE
  2738. -------------------------------------------------------------------------------
  2739. @NODE plcfgUse
  2740. @TITLE "Use Player/Noteplayer/Agent Configuration"
  2741.   @{b}Use:@{ub}      Saves the  APlayer.libs  file  in  the  ENV:APlayer/ directory.
  2742.             After the saving it closes the window and uses the settings. If
  2743.             the  current player/noteplayer is deleted from the list and you
  2744.             press use, the playing module will be ejected.
  2745. @ENDNODE
  2746. -------------------------------------------------------------------------------
  2747. @NODE plcfgCancel
  2748. @TITLE "Cancel Player/Noteplayer/Agent Configuration"
  2749.   @{b}Cancel:@{ub}   Closes the window and restores the settings.
  2750. @ENDNODE
  2751. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  2752. @NODE plcyc
  2753. @TITLE "List Selector"
  2754.   @{b}@{u}List Selector:@{uu}@{ub}
  2755.   @{"Players" LINK Players}     A player recognizes  and plays the  module. Some  feeds  the
  2756.                hardware directly, some passes the data to a noteplayer.
  2757.                When a player is selected (and if it uses a noteplayer), you
  2758.                can  press  the  "?"  button in the top right of the window.
  2759.                This  will  open  a  window  with  a list containing all the
  2760.                NotePlayers  which can be used by the player. Hereby you can
  2761.                select  the  NotePlayer  you  prefer should be used with the
  2762.                player.  If, for some reason, the NotePlayer isn't available
  2763.                when  the  player  tries to use it, it will scan through the
  2764.                NotePlayers until it finds a usable one.
  2765.   @{"NotePlayers" LINK NotePlayers} The noteplayer  recieves the sound data from  the player and
  2766.                makes your computer play the sound. Some of the  noteplayers
  2767.                has  the ability to mix several channels into the four audio
  2768.                channels of the amiga.
  2769.   @{"Agents" LINK Agents}      Agents are programs which can be  initiated  when  the  user
  2770.                performs a certain action.
  2771.   You can cycle trough the items with the keys < and >.
  2772.   Some (Note)Players are built  into the  main program  while  the rest  of
  2773.   them are stored as files in "LIBS:APlayer" or "LIBS:APlayer/NotePlayers".
  2774.   When APlayer has loaded a file, it has to  check which type of module  it
  2775.   is. With  this  window  you can decide which (Note)Players that should be
  2776.   used, and in which order they should be used (prioritized list).
  2777.   When  a (Note)Player  is chosen, the  version number  is displayed  in  a
  2778.   little box in the top left of the right part of the window.
  2779. @ENDNODE
  2780. --------------------------------------------------------------------------------
  2781. @NODE players
  2782. @TITLE "Players"
  2783.   @{b}@{u}Players:@{ub}@{uu}
  2784.   @{b}ActionAmics:@{ub}     This player is used in the game  "DynaBlaster",  so  you
  2785.                    can play the music from this game and rip the samples if
  2786.                    you like.
  2787. ---------------------------------------------------------------------------
  2788.   @{b}Activision Pro:@{ub}  This player is the same as Martin Walker player. You can
  2789.                    get some modules from old Activision games. There can be
  2790.                    some  trouble  on  faster  machines,  because the player
  2791.                    makes  CPU  loops.  The  player is inside the module, so
  2792.                    there isn't much to do about it.
  2793. ---------------------------------------------------------------------------
  2794.   @{b}ArtOfNoise:@{ub}      This player can play both 4 and 8 channels  modules.  It
  2795.                    have  some  great effect. It uses noteplayer to play the
  2796.                    modules.
  2797. ---------------------------------------------------------------------------
  2798.   @{b}DeliCustom:@{ub}      Yes,  that's  right.  Now  is  APlayer  able   to   play
  2799.                    Delitrackers  custom  modules.  Currently  there  is not
  2800.                    support  of  all  Delitrackers global functions or tags,
  2801.                    only  a  few. The modules I have, work just fine, but if
  2802.                    you  have  a module that doesn't work, please send it to
  2803.                    me.  You  can not pack these modules, because the player
  2804.                    has to load them as object files.
  2805. ---------------------------------------------------------------------------
  2806.   @{b}Delta20:@{ub}         Player is inside the module.  It  have  some  nice sound
  2807.                    effect.
  2808. ---------------------------------------------------------------------------
  2809.   @{b}DigitalMugician:@{ub} Nice player with some cool sound effects. The program is
  2810.                    not the most system friendly I have seen.
  2811. ---------------------------------------------------------------------------
  2812.   @{b}DSS:@{ub}             When you buy the DSS sampler, you will get a  music  and
  2813.                    sampler  program. The music program will save modules in
  2814.                    this  format,  so  with this player you are able to play
  2815.                    these type of modules.
  2816. ---------------------------------------------------------------------------
  2817.   @{b}FastTracker:@{ub}     I don't  know much  about this  player.  It's a 6 and  8
  2818.                    channels  ProTracker player. It  can do the  same as the
  2819.                    ProTracker  player, which  means  that it  has the  same
  2820.                    commands etc. This player uses a NotePlayer.
  2821. ---------------------------------------------------------------------------
  2822.   @{b}FastTracker20:@{ub}   This player can play the new format on the PC,  the *.XM
  2823.                    modules. The original music program on the PC is made by
  2824.                    Triton.  This  player  is coded by Jarno Paananen and it
  2825.                    uses a NotePlayer.
  2826. ---------------------------------------------------------------------------
  2827.   @{b}Fred:@{ub}            There is a lot of some nice fred tunes on  aminet,  some
  2828.                    of them by Jogeir. There is a player inside the modules,
  2829.                    but  I  have ripped one of them and added some features.
  2830.                    It  will  ofcourse  use  the player inside the module if
  2831.                    it's not the same as the one I know. Currently I support
  2832.                    2 different players, which only differs slightly.
  2833. ---------------------------------------------------------------------------
  2834.   @{b}FTM:@{ub}             This is a 8 voices player with one of  the  best  mixing
  2835.                    routine ever heard on the Amiga.
  2836. ---------------------------------------------------------------------------
  2837.   @{b}Future13:@{ub}        This  is  probably  the  most  used  type  of modules in
  2838.                    intros,  because  of  the  short  module size. It uses a
  2839.                    noteplayer.
  2840. ---------------------------------------------------------------------------
  2841.   @{b}Future14:@{ub}        This is the newer version of Future Composer. It can now
  2842.                    handle different wavetables. It uses a noteplayer.
  2843. ---------------------------------------------------------------------------
  2844.   @{b}Hippel:@{ub}          Argghh, this is one of the hard ones.  There is a player
  2845.                    inside each module, but they are all different.
  2846.                    If you  get a Hippel  module this player can't recognize
  2847.                    please mail it  to us if you want  APlayer to be able to
  2848.                    play it in the future..
  2849. ---------------------------------------------------------------------------
  2850.   @{b}Hippel-COSO:@{ub}     This is Hippel  modules  without  a  player  inside  the
  2851.                    module.  It  will  try  to load an extra sample  file if
  2852.                    needed,  but this hasn't  been tested,  because we don't
  2853.                    have any of these modules.  If you have one, please send
  2854.                    it to us.
  2855. ---------------------------------------------------------------------------
  2856.   @{b}IFF-8SVX:@{ub}        This player can  play the IFF-8SVX  sample format. It is
  2857.                    the  most used format on the Amiga. It can play any size
  2858.                    of  samples  by  loading  a little bit at the time. This
  2859.                    means  it  uses  low  memory  while running. It can also
  2860.                    handle   stereo  samples  and  IFF-crunched  (Fibonnaci)
  2861.                    samples, in both mono and stereo. It uses a noteplayer.
  2862.                    See how to @{"configure" LINK iffcfg} this player.
  2863. ---------------------------------------------------------------------------
  2864.   @{b}IFF-AIFF:@{ub}        This format is used on  the  Macintosh.  This player can
  2865.                    play  both 8 and 16 bit samples in both mono and stereo.
  2866.                    16 bit samples will be converted to 8 bit realtime while
  2867.                    playing. It uses a noteplayer.
  2868.                    See how to @{"configure" LINK aiffcfg} this player.
  2869. ---------------------------------------------------------------------------
  2870.   @{b}IFF-SMUS:@{ub}        This is a very old music format.  The format is designed
  2871.                    to  use with midi. This player will only play upto the 4
  2872.                    first priority voices.
  2873.                    See how to @{"configure" LINK smuscfg} this player.
  2874. ---------------------------------------------------------------------------
  2875.   @{b}InStereo!:@{ub}       This player is the  successor of Synthesis.  It can make
  2876.                    some nice chip sounds.
  2877. ---------------------------------------------------------------------------
  2878.   @{b}JamCracker:@{ub}      Is not the most used format,  but  there  is  some  nice
  2879.                    tunes   available   made  by  Dr.  Awesome.  It  uses  a
  2880.                    noteplayer.
  2881. ---------------------------------------------------------------------------
  2882.   @{b}JCBrooke:@{ub}        Nothing to say about this player.
  2883. ---------------------------------------------------------------------------
  2884.   @{b}MajorTom:@{ub}        I only got two modules in this format and has never seen
  2885.                    the music program. Anybody have it?
  2886. ---------------------------------------------------------------------------
  2887.   @{b}MarkCooksey:@{ub}     Nothing to say about this player.
  2888. ---------------------------------------------------------------------------
  2889.   @{b}MarkII:@{ub}          Nothing to say about  this player, except that the  main
  2890.                    replay routine is placed in each module.
  2891. ---------------------------------------------------------------------------
  2892.   @{b}MED:@{ub}             This player has one of the biggest  sources I  have ever
  2893.                    seen  (about  80Kb).  This player will play 4 voices MED
  2894.                    modules and can handle MMD0, MMD1 and MMD2 module types.
  2895.                    Please note  that  if  you  want  to  play  MED  modules
  2896.                    containing   synth  samples,  do  NOT  use  the  fastmem
  2897.                    noteplayer, since it will skip  all  synth  sounds.  Use
  2898.                    instead the paula noteplayer.
  2899.                    This Player uses a Noteplayer.
  2900. ---------------------------------------------------------------------------
  2901.   @{b}MON:@{ub}             Maniacs of Noise have created this player. The player is
  2902.                    inside the modules.
  2903. ---------------------------------------------------------------------------
  2904.   @{b}MusicAss:@{ub}        This format has  very  short  modules  with  the  player
  2905.                    inside the modules. I have ripped the player and fixed a
  2906.                    volume  bug  so  they  will  now  work on A4000. It will
  2907.                    of course only use the player inside the module if it is
  2908.                    not the same as the ripped one.
  2909. ---------------------------------------------------------------------------
  2910.   @{b}MultiTracker:@{ub}    This tracker is  a 1-32 channels  ProTracker player. The
  2911.                    file format is not the same as in normal mod files. This
  2912.                    player uses a NotePlayer.
  2913. ---------------------------------------------------------------------------
  2914.   @{b}NoisePacker20:@{ub}   This format is a packed NoiseTracker format  written  by
  2915.                    Twins of Phenomena.
  2916. ---------------------------------------------------------------------------
  2917.   @{b}NoisePacker30:@{ub}   Is a newer version of the NoiseTracker packer.
  2918. ---------------------------------------------------------------------------
  2919.   @{b}NoiseTracker:@{ub}    Before ProTracker this format was  the most used.  I use
  2920.                    the  same  player  as  in  the ProTracker player, but it
  2921.                    can't  change  the  CIA  tempo and it doesn't have any E
  2922.                    commands   except   for  the  filter  command.  See  the
  2923.                    ProTracker description for more information. This player
  2924.                    uses a NotePlayer.
  2925. ---------------------------------------------------------------------------
  2926.   @{b}OctaMed:@{ub}         This player is almost the same as the MED player, except
  2927.                    that it play 5-8 voices modules.
  2928.                    This player uses a Noteplayer.
  2929. ---------------------------------------------------------------------------
  2930.   @{b}Oktalyzer:@{ub}       A very old 8 voices format. It now uses a NotePlayer  to
  2931.                    mix the channels. This player uses a Noteplayer.
  2932. ---------------------------------------------------------------------------
  2933.   @{b}ProTracker:@{ub}      This format is probably  the most  known  format ever on
  2934.                    the  Amiga.  I  use  the  ProTracker version 1.1b player
  2935.                    written  by  Lars  "Zap" Hamre/Amiga Freelancers. I have
  2936.                    fixed  a lot of bugs (see the history :) and I have also
  2937.                    optimized  it  so  it  won't use so much CPU time as the
  2938.                    original player does. The  main  optimizing is that I've
  2939.                    changed all  the patterns  note periods to index numbers
  2940.                    in the  period  tables.  This removed  the routine which
  2941.                    searched  for the period in the period tables to get the
  2942.                    index  in  the finetunes period tables. This player uses
  2943.                    a NotePlayer to play the notes.
  2944. ---------------------------------------------------------------------------
  2945.   @{b}PumaTracker:@{ub}     I don't know anything about this player.  I  only have a
  2946.                    few modules of this type.
  2947. ---------------------------------------------------------------------------
  2948.   @{b}QuadraComposer:@{ub}  Got the player from the author, Bo Lincoln. Supports CIA
  2949.                    and all commands without crashing like in other players.
  2950.                    It also uses a noteplayer.
  2951. ---------------------------------------------------------------------------
  2952.   @{b}RIFF-WAVE:@{ub}       This format is used on the PC. It can play both 8 and 16
  2953.                    bit samples in mono or stereo. If the sample is too big,
  2954.                    it will be loaded in parts.
  2955.                    This player uses a Noteplayer.
  2956.                    See how to @{"configure" LINK riffcfg} this player.
  2957. ---------------------------------------------------------------------------
  2958.   @{b}RonKlaren:@{ub}       This player will play EaglePlayer  Ron  Klaren  modules.
  2959.                    This is the only type of module which cannot be crunched
  2960.                    because the files are loaded as object files.
  2961.                    There can be some problems on A4000.
  2962. ---------------------------------------------------------------------------
  2963.   @{b}ScreamTracker30:@{ub} This module format is probably one of the most  used  on
  2964.                    the  PC.  This  player  will  play  that  format.  Jarno
  2965.                    Paananen has coded the original player.  I have modified
  2966.                    it a little bit,  so it won't try  to play adlib samples
  2967.                    There  will  be  silence  instead of some crap sound. It
  2968.                    also uses a noteplayer.
  2969. ---------------------------------------------------------------------------
  2970.   @{b}SID:@{ub}             This play has to use the playsid.library to run.  It can
  2971.                    play all kinds of C64 songs by emulating the CPU and SID
  2972.                    in the C64.
  2973.                    See how to @{"configure" LINK sidcfg} this player.
  2974. ---------------------------------------------------------------------------
  2975.   @{b}SidMon10:@{ub}        Player is inside the module. I have  ripped  the  player
  2976.                    and  added  a few features. If the player isn't the same
  2977.                    as  the player inside the module, the inside player will
  2978.                    be used instead.
  2979. ---------------------------------------------------------------------------
  2980.   @{b}SidMon20:@{ub}        This is the new version of SidMon.  It hasn't the player
  2981.                    inside the module anymore.
  2982. ---------------------------------------------------------------------------
  2983.   @{b}SonicArranger:@{ub}   This player will play both songs and modules with player
  2984.                    inside  the  module.  With  modules it will use the song
  2985.                    player.
  2986. ---------------------------------------------------------------------------
  2987.   @{b}SoundControl:@{ub}    Nothing to say about this player.
  2988. ---------------------------------------------------------------------------
  2989.   @{b}SoundFactory:@{ub}    This player uses a Noteplayer.
  2990. ---------------------------------------------------------------------------
  2991.   @{b}SoundFX13:@{ub}       This player looks a lot like the SoundTracker player.
  2992. ---------------------------------------------------------------------------
  2993.   @{b}SoundFX20:@{ub}       A new  version  of  this  program.  It  now  supports 31
  2994.                    samples!! (whauww ;-)
  2995. ---------------------------------------------------------------------------
  2996.   @{b}SoundMon20:@{ub}      You can grab a lot of these (cool) modules on aminet.
  2997.                    This player uses a Noteplayer.
  2998. ---------------------------------------------------------------------------
  2999.   @{b}SoundMon22:@{ub}      This player uses a Noteplayer.
  3000. ---------------------------------------------------------------------------
  3001.   @{b}SoundTracker15:@{ub}  In this very OLD tracker only 15  samples  were allowed.
  3002.                    I  use  the  same  player  as in the ProTracker  player,
  3003.                    but it only supports the SoundTracker commands.
  3004.                    See  the  ProTracker  description  for more information.
  3005.                    This player uses a NotePlayer.
  3006. ---------------------------------------------------------------------------
  3007.   @{b}SoundTracker31:@{ub}  This is also a very OLD tracker but  it has 31  samples.
  3008.                    As  always  I  use  the same player as in the ProTracker
  3009.                    player.  See that description for more information. This
  3010.                    player uses a NotePlayer.
  3011. ---------------------------------------------------------------------------
  3012.   @{b}StarTrekker4:@{ub}    This player will play the normal  4  voices  StarTrekker
  3013.                    modules.
  3014. ---------------------------------------------------------------------------
  3015.   @{b}StarTrekker4AM:@{ub}  This player will play 4 voices StarTrekker modules  with
  3016.                    AM sounds. It needs the extra .nt file to the module.
  3017. ---------------------------------------------------------------------------
  3018.   @{b}Synthesis:@{ub}       See InStereo!
  3019. ---------------------------------------------------------------------------
  3020.   @{b}TakeTracker:@{ub}     This  player   is  exactly   the  same   player  as  the
  3021.                    FastTracker  player,  except that there is another  test
  3022.                    routine.  This  player supports 1 to 32 channels modules
  3023.                    and uses a noteplayer.
  3024. ---------------------------------------------------------------------------
  3025.   @{b}TFMX_15:@{ub}         This player can play the old TFMX formats. It's a format
  3026.                    created by Chris H
  3027. lsbeck.
  3028. ---------------------------------------------------------------------------
  3029.   @{b}TFMX_7V:@{ub}         This player can play the  7  voices  TFMX  modules.  The
  3030.                    player is coded by J. Hippel and C. H
  3031. lsbeck.
  3032. ---------------------------------------------------------------------------
  3033.   @{b}TFMX_Pro:@{ub}        Well, nothing more to say, except that this is the newer
  3034.                    version of TFMX modules.
  3035. ---------------------------------------------------------------------------
  3036.   @{b}TimFolin:@{ub}        With this player  you can hear  the really  cool modules
  3037.                    composed by Tim Follin. This player uses a Noteplayer.
  3038. ---------------------------------------------------------------------------
  3039.   @{b}TME:@{ub}             Nothing to say about this player.
  3040. ---------------------------------------------------------------------------
  3041.   @{b}TronicTracker:@{ub}   Nothing to say about this player.
  3042. ---------------------------------------------------------------------------
  3043.   @{b}VectorDean:@{ub}      This player is used  in  the  game  "Canon Fodder 2".  I
  3044.                    don't know if it was used in number 1 too.
  3045. ---------------------------------------------------------------------------
  3046.   @{b}VSS:@{ub}             Plays the Voodoo Supreme Synthesizer modules.
  3047. ---------------------------------------------------------------------------
  3048.   @{b}Whittaker:@{ub}       Player inside the module. The players are different from
  3049.                    each other, so you can get some problems.
  3050. @ENDNODE
  3051. --------------------------------------------------------------------------------
  3052. @NODE NotePlayers
  3053. @TITLE "NotePlayers"
  3054.   @{b}@{u}NotePlayers:@{uu}@{ub}
  3055.   @{b}14BitStereo-32Voices:@{ub}   Can mix upto 32 voices, into the four amiga sound
  3056.                           channels. The samples can be 8 bit and placed  in
  3057.                           both chip- and fast-mem. The mixing routine is 16
  3058.                           bit. If the mixing routine runs out of cpu  time,
  3059.                           the sample rate is lowered.
  3060.                           The main routine  is  based  on  Jarno  Paananens
  3061.                           routines, with some fixes and additions by me.
  3062.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3063. ---------------------------------------------------------------------------
  3064.   @{b}14BitStereo-2Voices:@{ub}    This Noteplayer can mix  upto 2 channels in 14bit
  3065.                           stereo, and it is therefore very handy  to use to
  3066.                           play samples e.g. IFF-8SVX.
  3067.                           See  the @{"14 Bit Stereo 2Voices configuration" LINK 2config} for
  3068.                           more info.
  3069. ---------------------------------------------------------------------------
  3070.   @{b}Fastmem-4Voices:@{ub}        This  play  modules  from  fastmemory. It  handles
  3071.                           both signed and unsigned samples.
  3072.                           See  the @{"Fastmem 4 Voices Configuration" LINK fastcfg} for  more
  3073.                           info.
  3074. ---------------------------------------------------------------------------
  3075.   @{b}Mono-32Voices:@{ub}          Can mix upto 32 voices, into the four amiga sound
  3076.                           channels. The samples can be 8 bit and placed  in
  3077.                           both  chip-  and  fast-mem. The mixing routine is
  3078.                           only 8 bit.
  3079.                           Please note that the mixer always plays in  mono,
  3080.                           even  if  some  channels  are  turned off. If the
  3081.                           mixing routine runs out of cpu time,  the  sample
  3082.                           rate is lowered.
  3083.                           The main routine  is  based  on  Jarno  Paananens
  3084.                           routines, with some fixes and additions by me.
  3085.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3086. ---------------------------------------------------------------------------
  3087.   @{b}Paula-4Voices:@{ub}          Passes on the data it gets from the player to the
  3088.                           sound chip. The samples can only be placed in the
  3089.                           chip memory.
  3090. ---------------------------------------------------------------------------
  3091.   @{b}ReSurround-32Voices:@{ub}    If  you  are  the  lucky  owner  of  a  surround
  3092.                           amplifier, you can connect your Amiga to  it  and
  3093.                           use  this player to listen to the modules in REAL
  3094.                           surround :).
  3095.                           It can mix upto 32 voices, into  the  four  amiga
  3096.                           sound  channels.  The  samples  can  be 8 bit and
  3097.                           placed  in  both  chip and fast-mem.  The  mixing
  3098.                           routine is only 8 bit.
  3099.                           Please note that the mixer always plays  in  real
  3100.                           surround,  even  if some channels are turned off.
  3101.                           If the mixing routine runs out of cpu  time,  the
  3102.                           sample rate is lowered.
  3103.                           The main routine  is  based  on  Jarno  Paananens
  3104.                           routines, with some fixes and additions by me.
  3105.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3106. ---------------------------------------------------------------------------
  3107.   @{b}Stereo-32Voices:@{ub}        Can mix upto 32 voices, into the four amiga sound
  3108.                           channels. The samples can be 8 bit and placed  in
  3109.                           both  chip-  and  fast-mem. The mixing routine is
  3110.                           only 8 bit. If the mixing routine runs out of cpu
  3111.                           time, the sample rate is lowered.
  3112.                           The main routine  is  based  on  Jarno  Paananens
  3113.                           routines, with some fixes and additions by me.
  3114.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3115. ---------------------------------------------------------------------------
  3116.   @{b}Surround-32Voices:@{ub}      Can mix upto 32 voices, into the four amiga sound
  3117.                           channels. The samples can be 8 bit and placed  in
  3118.                           both  chip-  and  fast-mem. The mixing routine is
  3119.                           only 8 bit.
  3120.                           Please  note  that  the  mixer  always  plays  in
  3121.                           surround,  even  if some channels are turned off.
  3122.                           If the mixing routine runs out of cpu  time,  the
  3123.                           sample rate is lowered.
  3124.                           The main routine  is  based  on  Jarno  Paananens
  3125.                           routines, with some fixes and additions by me.
  3126.                           See the @{"32 Voices configuration" LINK 32config} for more info.
  3127. @ENDNODE
  3128. --------------------------------------------------------------------------------
  3129. @NODE Fastcfg
  3130. @TITLE "Fastmem 4 Voices Configuration"
  3131.   @{b}@{u}Fastmem 4 Voices Configuration:@{uu}@{ub}
  3132.   Here you can set the size of the "Chip Memory Buffer" which is the amount
  3133.   of  CHIP memory used for every channel while playing from fastmemory. The
  3134.   default is 512, which suits  most configurations,  but if  it  gives  you
  3135.   trouble, you can try to change it.
  3136.   But remember that a smaller  buffer  makes  the  processor  work  harder,
  3137.   because  it has to copy the sampledata much more often than with a bigger
  3138.   buffer. But still, a big buffer can give some troubles, so try it out for
  3139.   yourself.
  3140. @ENDNODE
  3141. ---------------------------------------------------------------------------
  3142. @NODE 32config
  3143. @TITLE 32 Voices Configuration
  3144.   @{u}@{b}32 Voices Configuration:@{uu}@{ub}
  3145.   First of all you have to choose which mixing routine  you  want  to  use.
  3146.   This  can  either  be  the  68000/68010  or  68020+.  The 68020+ mixer is
  3147.   ofcourse optimized for higher processors.
  3148.   This configuration is used to set the mixing rate relative to the  number
  3149.   of channels used in a module. This means that the higher mixing rate, the
  3150.   better sound. But remember that high mixing rates demands more cpu power.
  3151.   As  soon as you press return, after you have typed a new mixing rate, the
  3152.   new mixing rate is used. This is ofcourse only if you  have  changed  the
  3153.   mixing rate for the current number of used channels.
  3154.   You can also set the volume boost for every number of  channels.  If  you
  3155.   are  listening  to  modules  that  uses  a  lot of channels, you can take
  3156.   advantage of volume boost. This is because if a lot of channels has to be
  3157.   mixed, the volume will be lowered,  and therefore it needs to be boosted.
  3158.   The boost value will only take effect when a new module is played.
  3159.   If you don't know which values to type in, you can get APlayer to  choose
  3160.   the values best suited for your system.  This can be done by pressing the
  3161.   autoadjust button. It CAN'T be done if APlayer is playing  a  module,  or
  3162.   the audio channels is allocated by another program.
  3163.   First, you are asked if you want to check all the channels. If you answer
  3164.   NO, only the 31-32  channel mode is tested, and the result is used in all
  3165.   other channels mode, else every channel mode is tested.
  3166.   Then you can decide the maximum mixing rate to be used.  This  can  be  a
  3167.   number between 4000 and 56000. The higher the mixing rate, the better the
  3168.   sound quality.
  3169.   The last two requesters will let you decide wether you want to adjust the
  3170.   found  mixing  rate a bit down (0-100 percent), which will leave more cpu
  3171.   power to the rest of the system.
  3172.   After this the test is performed. To optimize the results, do  NOT  touch
  3173.   your computer while the test is in progress. You can adjust the volume in
  3174.   the main window, if you don't want to hear the tones while  the  test  is
  3175.   running.
  3176.   @{b}Please note  that the numbers  found in the test  may not be the  optimal
  3177.   setting, but should give you a hint on how the setting should be.@{ub}
  3178.   Click @{"here" LINK prefsmenu} to see how to use the menus in this window.
  3179. @ENDNODE
  3180. --------------------------------------------------------------------------------
  3181. @NODE 2config
  3182. @TITLE "14 Bit Stereo 2Voices configuration"
  3183.   @{b}@{u}14 Bit Stereo 2Voices configuration:@{uu}@{ub}
  3184.   Here you can set the size of the "Chip Memory Buffer" which is the amount
  3185.   of  CHIP memory used for every channel while playing from fastmemory. The
  3186.   default is 512, which suits  most configurations,  but if  it  gives  you
  3187.   trouble, you can try to change it.
  3188.   The "Maximum Sample Rate" will cause every sample with a higher frequency
  3189.   than  the  specified,  to  be downsampled to that frequency. Normally the
  3190.   amiga hardware will not allow you to play samples with a higher frequency
  3191.   than 28867 Hz. Therefore you can use this noteplayer to play samples with
  3192.   frequencies above this, with the right speed.
  3193. @ENDNODE
  3194. --------------------------------------------------------------------------------
  3195. @NODE Agents
  3196. @TITLE "Agents"
  3197.   @{u}@{b}Agent Types:@{uu}@{ub}
  3198.   @{b}SampleSavers:@{ub}
  3199.   -------------
  3200.   The sample saver agent will be started when the  user  presses  the  save
  3201.   sample  gadget  in  the  sample  info  window. The agent can then perform
  3202.   certain actions on the chosen sample. If more than one samplesaver  agent
  3203.   is present in the list, the uppermost will be used.
  3204.     @{"Multi" LINK Multi} Converts and saves samples in multiple formats
  3205.   @{b}Scopes:@{ub}
  3206.   -------
  3207.   Scopes are different types of displays that illustrates the modules being
  3208.   played. They may flash, rotate and do all sorts of funky stuff.
  3209.   NB: Only when playing a module whose @{"player" LINK Players} uses a noteplayer, the scopes
  3210.   will be utilized.
  3211.     @{"RGB-box" LINK RGB-box}
  3212.     @{"SpinSquares" LINK SpinSquares}
  3213.     @{"Bar Scope" LINK Barscope}
  3214.   @{b}Favourite Song System (FSS):@{ub}
  3215.   ----------------------------
  3216.   Displays a list of the most often heard modules on your computer.
  3217.   @{" Favourite Song System (FSS) " LINK FSS}
  3218. @ENDNODE
  3219. --------------------------------------------------------------------------------
  3220. @NODE multimods
  3221. @TITLE "Multi Sample Formats"
  3222.   @{u}@{b}Sample formats:@{uu}@{ub}
  3223.   @{b}IFF-8SVX@{ub}        : The most normal format in the amiga world. It  supports
  3224.                     8  bit  quality,  mono/stereo  and  fibonacci  packing.
  3225.                     Fibonacci packing will halve the  size  of  the  sample
  3226.                     with nearly no quality loss :)
  3227.                     In the configuration you can  specify the internal name
  3228.                     of the sample and the author name, and whether you want
  3229.                     the sample packed with fibonacci or not.
  3230.                     If the sample is in stereo you have the possibility  to
  3231.                     save  it  as either a mono or a stereo sampling. If you
  3232.                     choose mono, the channels are mixed in 16  bit  quality
  3233.                     and then saved as an 8 bit mono sampling.
  3234.   @{b}IFF-AIFF@{ub}        : This format originates from the Macintosh. It is mostly
  3235.                     used  on  the Macintosh,  but it's also  used by  other
  3236.                     platforms.
  3237.                     This converter supports conversion of 8 and 16 bit AIFF
  3238.                     samples,  mono  or  stereo.  To  see  which conversions
  3239.                     between stereo and mono that are possible see above  in
  3240.                     the IFF-8SVX description.
  3241.                     16 bit samples can be saved in  8  or  16  bit.  8  bit
  3242.                     samples can only be converted in 8 bit.
  3243.                     Like in the IFF-8SVX you can also specify  an  internal
  3244.                     name and author for the sample.
  3245.   @{b}RAW :@{ub}             This  is  all  files  not covered by  the  above sample
  3246.                     formats. It can be anything from an  executeable  to  a
  3247.                     device  handler.  This is useful if you have some files
  3248.                     which you KNOW are samples but  they  haven't  got  any
  3249.                     header.  In the config you can tell APlayer exactly how
  3250.                     the sample is, and with this informations APlayer  will
  3251.                     create a header for the file.
  3252.                     The things that you have to tell APlayer is:
  3253.                     Quality   : 8 or 16 bit
  3254.                     Endian    : Big (highbyte first),Little (lowbyte first)
  3255.                                 This is pretty technical, only change it if
  3256.                                 nothing else works.
  3257.                     Type      : Signed or unsigned
  3258.                     Channels  : Mono or stereo
  3259.                     Frequency : The samplerate (5000 - 28000).
  3260. @ENDNODE
  3261. --------------------------------------------------------------------------------
  3262. @NODE Multi
  3263. @TITLE "SampleSaver - Multi"
  3264.   @{b}@{u}Multi SampleSaver:@{ub}@{uu}
  3265.   This agent can save and convert samples between different @{"sample formats" LINK multimods}.
  3266.   To edit some general  settings  for  the  Multi  SampleSaver,  enter  the
  3267.   @{"configuration window" LINK MultiSampleSaverConfig} belonging to it.
  3268.   @{i}How to Convert a sample:@{ui} Go to the players configuration window and go to
  3269.   the  agent  section.  Select the Multi agent and press the "show" gadget.
  3270.   Then you have the possibility to select which format of  the  sample  you
  3271.   want  to  convert.  If you select automatic, then the agent will find the
  3272.   sample type automatically. Now you have to select the format to which the
  3273.   sample is converted. To convert the sample, press "Convert".
  3274.   Choose the sample to be converted from the filerequester.
  3275.   A window will then popup with some info about the sample:
  3276.   Format   : The format of the sample (e.g. IFF-8SVX or IFF-AIFF)
  3277.   Name     : The internal sample name
  3278.   Author   : The author of the sample
  3279.   length   : The length of the sample without any headers
  3280.   Loop     : Is there a loop in this sample?
  3281.   Rate     : The samplerate in samples/second
  3282.   Channels : The number of channels used in the sampling
  3283.   Quality  : The quality of the sample (e.g. 8 or 16 bit)
  3284.   Type     : Signed, unsigned, fibonacci (delta encoded), ulaw or alaw
  3285.   Endian   : Big (highbyte first), Little (lowbyte first)
  3286.   Press "Okay" and write the filename of the sample you want  to  save.  If
  3287.   the  saver has some settings for you to change, a window will pop up now.
  3288.   To start the conversion just close the window.
  3289.   @{i}How to Save a sample:@{ui} While you are playing a module you select a  sample
  3290.   from  the  sample  info  window.  Press  the save gadget in the top right
  3291.   corner to start the multi sample saver agent. A filerequester will  popup
  3292.   asking you for the name you want to save the sample under. Write the name
  3293.   and press return.
  3294.   Then you can select which format you want to save the sample as.  If  the
  3295.   saver has some configurations for you to change, a window will popup when
  3296.   you press @{b}save@{ub}. If not, the sample will just be saved.
  3297. @ENDNODE
  3298. --------------------------------------------------------------------------------
  3299. @NODE MultiSampleSaverConfig
  3300. @TITLE "Multi SampleSaver Configuration"
  3301.   @{b}@{u}Multi SampleSaver Configuration:@{uu}@{ub}
  3302.   Load Path: This is the default directory where you keep your samples.
  3303.   Save Path: This is the directory where you want your converted samples to
  3304.              be saved to.
  3305.   Xpk packing: Selects wether you want  the converted samples  to be packed
  3306.                with xpk and with which library/packer.
  3307.   Effectiveness: This decides  how good/effective  you want the  chosen xpk
  3308.                  packer to be.
  3309.   Enable Info: Here you can tell  the  information  window  not  to  appear
  3310.                everytime it loads a sample. This is useful if you  want  to
  3311.                convert  a  lot of samples, then you won't have to press the
  3312.                OK gadget in the information window for every new sample.
  3313.                Note that this is only really useful in conjunction with the
  3314.                "Enable Config" switch described below.
  3315.   Enable Cfg: This disables the save configuration  windows for the  sample
  3316.               savers.  If  you  just  want  the  samples  saved  with   the
  3317.               information  APlayer  gets  from  the  sample  you  choose to
  3318.               convert, you can disable the configuration here.
  3319. @ENDNODE
  3320. --------------------------------------------------------------------------------
  3321. @NODE RGB-box
  3322. @TITLE "The RGB-Box Scope Agent"
  3323.   A window of configurable size consisting of a  square.  The  square  will
  3324.   flash  in  time to the first three tracks of the module being played. Any
  3325.   additional tracks will have no effect on the RGB-box.
  3326.   The colors are chosen so that the first  track  controls  the  red  color
  3327.   value,  the  second  track  the green color value, and the third the blue
  3328.   value. Each note in a given track retrigs the corresponding color  value.
  3329.   The higher the volume, the brighter the color.
  3330. @ENDNODE
  3331. --------------------------------------------------------------------------------
  3332. @NODE SpinSquares
  3333. @TITLE "The Spinning Squares Scope Agent"
  3334.   This  agent  consists  of  a  window  divided  into  four  squares,  each
  3335.   containing  its  own  vector-box.  The  box  will  expand and contract in
  3336.   correspondence to the notes being played  in  the  track  it  represents.
  3337.   Factors in deciding the changes are volume and pitch.
  3338.   Configuration  of  this  agent :
  3339.   Rotation : Controls whether the vector-boxes should rotate or not.
  3340.   Double Height: Doubles the height of the scopes. This is  useful  if  you
  3341.   are running APlayer on a 1x1 resolution screen.
  3342.   GfxCard Safety :  When  ON,  disables  multitasking  during  the  drawing
  3343.   routines  to  avoid  the  flickers  that  may  appear  if you are using a
  3344.   Graphics Board that uses the processor in stead of the blitter.
  3345. @ENDNODE
  3346. -------------------------------------------------------------------------------
  3347. @NODE barscope
  3348. @TITLE "The Bar Scope Agent"
  3349.   Look at it and see if you can figure out how it works :)
  3350.   A lot of greetings to  Hans Henrik Happe for coding this really wonderful
  3351.   resizeable scope.
  3352. @ENDNODE
  3353. -------------------------------------------------------------------------------
  3354. @Node Fss
  3355. @TITLE "Favourite Song System"
  3356.   @{u}@{b}Favourite Song System:@{uu}@{ub} (Shortkey f)
  3357.   The Favourite Song System (FSS) is  for  you  who  can't  remember  which
  3358.   modules you like to hear. Okay, that was a bit of a joke! If you add this
  3359.   agent to your agent list, it will automatically store the  names  of  all
  3360.   the  modules  your  have  heard  during  your last run of the APlayer.
  3361.   In addition to that it remembers how many times you have heard  the  same
  3362.   module. All the names are put into a list, from which the FSS-Agent takes
  3363.   a user specified number of played modules and put them into the "Favorite
  3364.   Song System" window. This window displays the top list placements and how
  3365.   many times each module has been played.
  3366.   To control the behaviour of the agent see the @"FSS-Agent configuration" LINK FSS-config}.
  3367.   When you choose to SHOW the FSS window  you  will  be  presented  with  a
  3368.   window containing a list and some buttons.
  3369.   The list contains the names of the modules and how a number  stating  how
  3370.   many times each module has been played.
  3371.   If you doubleclick an item in the list it will be added to the bottom  of
  3372.   the module list
  3373.   @{b}RND One:@{ub} This will randomly choose  a module from the list and  add it to
  3374.            the bottom of the module list.
  3375.   @{b}RND All:@{ub} Shuffles all the Top-10 modules and put them in the module list.
  3376.   @{b}Delete:@{ub}  Deletes the marked module from the fss list. The changes will be
  3377.            saved to your fss file the  next time you either quit the player
  3378.            or open the fss window.
  3379.   @{b}Reset:@{ub}   Asks  if you  wants  to clear the  FSS list from  the memory and
  3380.            delete the FSS file on your disk too.
  3381. @ENDNODE
  3382. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3383. @NODE FSS-Config
  3384. @TITLE "Favourite Song System Configuration"
  3385.   @{b}Favourite Song System Configuration:@{ub}
  3386.   The following options for the FSS Agent can be controlled by you:
  3387.   Save FSS List: Here you decides when and how often the FSS list should be
  3388.                  saved  to  a  file.  None of the possibilities exclude the
  3389.                  others, so you can choose to  save  when  the  FSS  (Show)
  3390.                  window  opens (default), when  it closes  and additionally
  3391.                  you can choose to save the list every x'th minute.
  3392.                  The default is every 15th minute.
  3393.   With the cycle you decides how many, and which, modules you want the list
  3394.   to show to the user.
  3395.   It can be the top 10 (default), top 50, top 100 or top xxx where you type
  3396.   the xxx value to the right of the cycle.
  3397.   Alternatively you can show the worst 10 or worst xxx modules in the list.
  3398.   The FSS Path tells the FSS Agent where to save the FSS list file.
  3399.   @{b}Optimize Tree:@{ub}
  3400.   This  will simply optimize the FSS tree and lists. The optimizer will ask
  3401.   you  for  a  min  hear  number which will cause the optimizer to wipe all
  3402.   modules heard less than the specified number of times, from the list.
  3403.   For a more technical description of this click here .. no @{"here" LINK OptimizeFSS} :)
  3404.   @{b}Convert to APML File:@{ub}
  3405.   This converts your FSS (Favourite Song System) file to an  APML  (APlayer
  3406.   Module  List)  file.  A file requester will pop up to ask you on where to
  3407.   save the APML file.
  3408.   To save, use or  cancel  the  FSS  configuration  use  the  corresponding
  3409.   buttons at the bottom of the window.
  3410. @ENDNODE
  3411. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3412. @NODE OptimizeFSS
  3413.   @{b}Optimize FSS List:@{ub}
  3414.   As you maybe have guessed, the FSS will store all the  modules  you  have
  3415.   heard  as  a  binary tree. This is because it's the fastest way to search
  3416.   for a file to see if it already exist when you load a new module. If  you
  3417.   know  a  little  bit  about binary trees, you will properly know that the
  3418.   tree will get unbalanced after a while. The term  unbalanced  is  further
  3419.   described in the figures below:
  3420.                                      8
  3421.                                     / \
  3422.                                    3   9
  3423.                                   / \
  3424.                                  2   4
  3425.                                       \
  3426.                                        5
  3427.                            Fig1: Unbalanced Tree
  3428.                                      5
  3429.                                     / \
  3430.                                    3   8
  3431.                                   / \   \
  3432.                                  2   4   9
  3433.                            Fig2: The same tree, but balanced
  3434.   A tree can be divided into two subtrees, from the  root.  The  trees  are
  3435.   split  in  layers,  for  instance  the unbalanced tree in fig.1 has got 4
  3436.   layers, while fig.2 has got 3  layers.  If  a  tree  is  unbalanced  it's
  3437.   because  the  difference  between  the  number  of layers in the two main
  3438.   subtrees is bigger than one.
  3439.   If the tree isn't balanced, it will decrease the search time. Let's  take
  3440.   an example: if you will insert the number 7 in figure 1, you have to test
  3441.   4 other nodes (8, 3, 4 & 5) to know where to place it, but  in  figure  2
  3442.   you  only need 2 tests (5 & 8). Now you can see, the search time has been
  3443.   halfed.
  3444.   This is what this function does, it balances the binary tree (from now on
  3445.   named  AVL-trees).  It will test if the modules are still present on your
  3446.   HD and if they aren't they will be deleted from the  tree.  If  you  have
  3447.   some  modules  on  floppy disk the optimizer asks for the disk. To delete
  3448.   the module from the tree just cancel the disk requesters.
  3449. @ENDNODE
  3450. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3451. @Node Modtypes
  3452. @Title "Module Types"
  3453.                                                                 |F |
  3454.                                                                 |o |
  3455.                                                                 |r |
  3456.                                                                 |c |
  3457.                                                     |M |S |P |  |e |
  3458.                                                     |a |h |l |  |  |
  3459.                                      |M |           |x |o |a |  |F |  |O |N |
  3460.                                      |o |   *       |  |w |y |A |i |  |w |o |
  3461. +-                                |C |d |  |S |  |P |P |  |  |c |l |  |n |t |
  3462.   +-               |F |           |h |u |  |u |  |o |a |S |S |c |t |F |  |e |
  3463.     +-          |R |o |  |V |     |a |l |A |b |L |s |t |a |a |o |e |a |C |P |
  3464.       +-  Func. |e |r |P |o |  |T |n |e |u |s |e |i |t |m |m |m |r |s |o |l |
  3465.         +-      |w |w |a |l |F |e |n |n |t |o |n |t |e |p |p |p |  |t |n |a |
  3466.           +-    |i |a |u |u |a |m |e |a |h |n |g |i |r |l |l |a |O |m |f |y |
  3467.  Players:   +-  |n |r |s |m |d |p |l |m |o |g |t |o |n |e |e |n |f |e |i |e |
  3468.               +-|d |d |e |e |e |o |s |e |r |s |h |n |s |s |s |y |f |m |g |r |
  3469. ----------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  3470. ActionAmics     |X |X |X |X |  |X |X |  |X |X |X |X |  |X |X |X |X |  |  |  |
  3471. ActivisionPro   |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3472. ArtOfNoise      |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3473. DeliCustom      |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3474. Delta20         |  |  |X |X |  |X |  |  |  |  |  |  |  |  |  |  |X |  |  |  |
  3475. DigitalMugician |X |X |X |X |X |X |  |X |  |X |X |X |X |  |  |  |X |  |  |  |
  3476. DSS             |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |  |X |  |  |  |
  3477. FastTracker     |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3478. FastTracker20   |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3479. Fred            |  |  |X |X |  |X |X |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3480. FTM             |  |  |X |X |  |  |  |X |X |  |X |X |  |  |  |  |  |X |  |  |
  3481. Future13        |X |X |X |X |  |X |X |  |  |  |X |X |  |  |  |  |X |X |  |X |
  3482. Future14        |X |X |X |X |  |X |X |  |X |  |X |X |  |X |X |X |X |X |  |X |
  3483. Hippel          |  |  |X |  |  |X |  |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3484. Hippel-COSO     |  |  |X |X |  |X |  |  |X |X |X |X |  |  |  |  |X |  |  |  |
  3485. IFF-8SVX        |  |X |X |X |  |X |X |X |X |  |X |X |  |  |  |  |  |X |@{"X" link iffcfg}|X |
  3486. IFF-AIFF        |  |  |  |X |  |X |  |X |X |  |X |X |  |  |  |  |X |  |@{"X" link aiffcfg}|X |
  3487. IFF-SMUS        |  |  |X |X |  |X |X |X |X |  |  |  |  |  |  |  |X |  |@{"X" link smuscfg}|  |
  3488. InStereo!       |X |X |X |X |  |X |X |X |  |X |X |X |  |  |  |  |X |  |  |  |
  3489. JamCracker      |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3490. JCBrooke        |  |  |X |  |  |X |  |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3491. MajorTom        |X |X |X |X |X |X |  |  |  |  |X |X |X |  |  |  |X |  |  |  |
  3492. MarkCooksey     |  |  |X |  |  |X |  |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3493. MarkII          |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |  |
  3494. MED             |X |X |X |X |  |  |X |  |X |X |X |X |X |X |X |X |X |  |  |X |
  3495. MON             |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3496. MultiTracker    |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3497. MusicAss        |  |  |X |X |  |X |X |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3498. NoisePacker20   |X |X |X |X |X |X |  |  |  |  |X |X |X |  |  |  |X |  |  |  |
  3499. NoisePacker30   |X |X |X |X |X |X |  |  |  |  |X |X |X |  |  |  |X |  |  |  |
  3500. NoiseTracker    |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3501. OctaMed         |X |X |X |  |  |  |  |  |X |X |X |X |X |X |X |  |  |  |  |  |
  3502. Oktalyzer       |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |X |  |X |
  3503. ProTracker      |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3504. PumaTracker     |X |X |X |X |X |X |X |X |  |  |X |X |X |  |  |  |X |  |  |  |
  3505. QuadraComposer  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3506. RIFF-WAVE       |  |X |X |X |  |X |X |  |  |  |X |X |  |  |  |  |X |X |@{"X" link riffcfg}|X |
  3507. RonKlaren       |  |  |X |  |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3508. ScreamTracker30 |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3509. SID             |X |X |X |  |  |  |X |X |X |X |  |  |  |  |  |  |  |  |@{"X" link sidcfg}|  |
  3510. SidMon10        |X |X |X |X |  |X |  |  |  |  |X |X |  |  |  |  |X |  |  |  |
  3511. SidMon20        |X |X |X |X |X |X |X |  |  |  |X |X |  |  |  |  |X |  |  |  |
  3512. SonicArranger   |X |X |X |X |  |X |X |  |X |X |X |X |  |X |X |X |X |  |  |  |
  3513. SoundControl    |X |X |X |X |  |X |X |X |  |  |X |X |  |  |  |  |X |  |  |  |
  3514. SoundFactory    |  |  |X |X |  |X |X |  |  |X |  |  |  |  |  |  |X |X |  |X |
  3515. SoundFX13       |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |  |  |  |
  3516. SoundFX20       |X |X |X |X |X |X |X |  |X |  |X |X |X |X |X |X |X |  |  |  |
  3517. SoundMon20      |X |X |X |X |  |X |X |X |  |  |X |X |X |  |  |  |X |X |  |X |
  3518. SoundMon22      |X |X |X |X |  |X |X |X |  |  |X |X |X |  |  |  |X |X |  |X |
  3519. SoundTracker15  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3520. SoundTracker31  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3521. StarTrekker4    |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |  |  |  |
  3522. StarTrekker4AM  |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |  |  |  |
  3523. Synthesis       |X |X |X |X |  |X |  |X |  |X |X |X |  |  |  |  |X |  |  |  |
  3524. TakeTracker     |X |X |X |X |X |X |X |X |X |  |X |X |X |X |X |X |X |X |  |X |
  3525. TFMX_15         |X |X |X |X |  |X |  |  |X |X |X |X |  |  |  |  |X |  |  |  |
  3526. TFMX_7V         |X |X |  |X |  |  |  |  |X |X |X |X |  |  |  |  |  |  |  |  |
  3527. TFMX_Pro        |X |X |X |X |  |  |  |  |X |X |X |X |  |  |  |  |  |  |  |  |
  3528. TimFolin        |  |  |X |X |  |X |X |  |X |X |  |  |  |  |  |  |X |X |  |X |
  3529. TME             |X |X |X |X |X |X |X |X |X |X |X |X |  |X |X |X |X |  |  |  |
  3530. TronicTracker   |X |X |X |X |  |X |X |  |  |  |X |X |  |  |  |  |X |  |  |  |
  3531. VectorDean      |  |  |X |X |  |X |  |  |  |X |  |  |  |  |  |  |X |  |  |  |
  3532. VSS             |  |  |X |X |  |X |  |  |  |  |  |  |  |  |  |  |X |  |  |  |
  3533. Whittaker       |  |  |X |X |  |X |X |  |X |X |  |  |  |  |  |  |X |  |  |  |
  3534. ----------------+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
  3535. * For further info, see @{"Tunes" LINK tunes}.
  3536. @ENDNODE
  3537. --------------------------------------------------------------------------------
  3538. @NODE iffcfg
  3539. @TITLE "IFF-8SVX Configuration"
  3540.   @{u}@{b}IFF-8SVX Config:@{ub}@{uu}
  3541.   The IFF-8SVX player works by loading a  sample  bit  by  bit  (buffer  by
  3542.   buffer)  and  play  it. As user you can define how big each buffer should
  3543.   be and how much memory that should be used at maximum.
  3544.   @{b}Load buffer size in Kb:@{ub} The size of each load buffer. Please note that if
  3545.   you want a buffer size of e.g. 64 Kb and you try to load a 20 Kb  sample,
  3546.   then  the  player  will  allocate  a 64 Kb buffer. That is, no matter how
  3547.   small or large your sample is, only whole buffers will be allocated. e.g.
  3548.   a 75 Kb sample will need for instance two 64 Kb buffers.
  3549.   Note1: If you play stereo samples the buffer size will be doubled.
  3550.   Note2: Fibonacci packed samples will use an extra buffer,  sized  half of
  3551.   the load buffer size, for depacking.
  3552.   @{b}Max memory to use in Kb:@{ub} The maximum amount of memory to be used for load
  3553.   buffers. This number should at least be six times the size  of  the  load
  3554.   buffer size (because of double buffering and stereo). If you haven't  got
  3555.   enough  free  memory to allocate 6 times the size of the load buffer, the
  3556.   playback of the sample can get corrupted.
  3557.   Obs: If your harddisk have problems keeping up with  loading  the  sample
  3558.   buffers, it might help to increase the buffer size.
  3559.   @{b}Play only once:@{ub} This  will  tell APlayer only to play the sample once, no
  3560.   matter how big it is.
  3561. @ENDNODE
  3562. --------------------------------------------------------------------------------
  3563. @NODE aiffcfg
  3564. @TITLE "IFF-AIFF Configuration"
  3565.   @{u}@{b}IFF-AIFF Config:@{ub}@{uu}
  3566.   The IFF-AIFF player works by loading a  sample  bit  by  bit  (buffer  by
  3567.   buffer)  and  play  it. As user you can define how big each buffer should
  3568.   be and how much memory that should be used at maximum.
  3569.   @{b}Load buffer size in Kb:@{ub} The size of each load buffer. Please note that if
  3570.   you want a buffer size of e.g. 64 Kb and you try to load a 20 Kb  sample,
  3571.   then  the  player  will  allocate  a 64 Kb buffer. That is, no matter how
  3572.   small or large your sample is, only whole buffers will be allocated. e.g.
  3573.   a 75 Kb sample will need for instance two 64 Kb buffers.
  3574.   Note1: If you play stereo samples the buffer size will be doubled.
  3575.   @{b}Max memory to use in Kb:@{ub} The maximum amount of memory to be used for load
  3576.   buffers. This number should at least be six times the size  of  the  load
  3577.   buffer size (because of double buffering and stereo). If you haven't  got
  3578.   enough  free  memory to allocate 6 times the size of the load buffer, the
  3579.   playback of the sample can get corrupted.
  3580.   Obs: If your harddisk have problems keeping up with  loading  the  sample
  3581.   buffers, it might help to increase the buffer size.
  3582.   @{b}Play only once:@{ub} This  will tell APlayer only to play the sample  once, no
  3583.   matter how big it is.
  3584. @ENDNODE
  3585. --------------------------------------------------------------------------------
  3586. @NODE riffcfg
  3587. @TITLE "RIFF-WAVE Configuration"
  3588.   @{u}@{b}RIFF-WAVE Config:@{ub}@{uu}
  3589.   The RIFF-WAVE player works by loading a  sample  bit  by  bit  (buffer by
  3590.   buffer)  and  play  it. As user you can define how big each buffer should
  3591.   be and how much memory that should be used at maximum.
  3592.   @{b}Load buffer size in Kb:@{ub} The size of each load buffer. Please note that if
  3593.   you want a buffer size of e.g. 64 Kb and you try to load a 20 Kb  sample,
  3594.   then  the  player  will  allocate  a 64 Kb buffer. That is, no matter how
  3595.   small or large your sample is, only whole buffers will be allocated. e.g.
  3596.   a 75 Kb sample will need for instance two 64 Kb buffers.
  3597.   Note1: If you play stereo samples the buffer size will be doubled.
  3598.   @{b}Max memory to use in Kb:@{ub} The maximum amount of memory to be used for load
  3599.   buffers. This number should at least be six times the size  of  the  load
  3600.   buffer size (because of double buffering and stereo). If you haven't  got
  3601.   enough  free  memory to allocate 6 times the size of the load buffer, the
  3602.   playback of the sample can get corrupted.
  3603.   Obs: If your harddisk have problems keeping up with  loading  the  sample
  3604.   buffers, it might help to increase the buffer size.
  3605.   @{b}Play only once:@{ub} This  will tell APlayer only to  play the sample once, no
  3606.   matter how big it is.
  3607. @ENDNODE
  3608. --------------------------------------------------------------------------------
  3609. @NODE sidcfg
  3610. @TITLE "SID Configuration"
  3611.   @{u}@{b}SID Config:@{ub}@{uu}
  3612.   @{b}Use Rewind Buffers:@{ub} If you  want to be able  to use  rewind when  you are
  3613.   playing SID modules, then check this ON.
  3614.   @{b}Warning: This uses  a lot of memory  (approximately 0.5 kb/sec), so don't
  3615.   use it if you can't live without the memory!@{ub}
  3616.   @{b}Rewind Speed:@{ub} This slider is used to decide how much the tune  should  be
  3617.   rewound  every time you push the  rewind button. (For advanced users: The
  3618.   amount is the number of frames that should be rewound).
  3619.   @{b}Forward Speed:@{ub} This slider is used to decide how much the tune should  be
  3620.   forwarded  every time you push  the forward  button. (For advanced users:
  3621.   The amount is the number of frames that should be forwarded).
  3622.   I love copying text frames... :-)
  3623. @ENDNODE
  3624. --------------------------------------------------------------------------------
  3625. @NODE smuscfg
  3626. @TITLE "IFF-SMUS Configuration"
  3627.   @{u}@{b}IFF-SMUS Config:@{ub}@{uu}
  3628.   @{b}Instrument Path:@{ub} The full path  or an assign name  to the place where the
  3629.   instruments for your SMUS modules are to be found. The path can be chosen
  3630.   by pressing the diskgadget to the right of the string gadget.
  3631. @ENDNODE
  3632. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3633. -------------------------------------------------------------------------------
  3634. @NODE cfgsaveusecancel
  3635. @TITLE "Configuration - Save/Use/Cancel"
  3636.   @{b}Save   :@{ub} This  will  save the preferencefiles in both ENV:APlayer/ and in
  3637.            your  ENVARC:APlayer/  directory.  It will also close the config
  3638.            window.
  3639.   @{b}Use    :@{ub} Pressing  this will save the preferencefiles in ENV:APlayer/ and
  3640.            close the configuration window.
  3641.   @{b}Cancel :@{ub} This  will close the config window and  restore your preferences
  3642.            as they were before the config window was opened.
  3643.   @{b}Among@{ub} all the settings saved in the prefs file is the state of  the  main
  3644.   window  cycle,  module  loop,  sound  channels  and  the speed and volume
  3645.   settings.
  3646. @ENDNODE
  3647. >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
  3648. -------------------------------------------------------------------------------
  3649. @NODE INDEXNODE "Index"
  3650.  @{b}APlayer Index:@{ub}
  3651.  @{b}<Numeric>@{ub}
  3652.  @{"14 Bit Stereo 2Voices configuration" LINK 2config}
  3653.  @{"32 Voices Configuration" LINK 32config}
  3654.  @{b}A@{ub}
  3655.  @{"About Window" LINK About}
  3656.  @{"Activate ARexx" LINK ActivateARexx}
  3657.  @{"Add Item, Players/Noteplayers/Agents" LINK plcfgAdd}
  3658.  @{"Adjust Speed" LINK Speed}
  3659.  @{"Adjust Volume" LINK Volume}
  3660.  @{"Agents" LINK Agents}
  3661.  @{"Allocate Channels" LINK AllocateChannels}
  3662.  @{"APML Path" LINK APMLpath}
  3663.  @{"App Popup/Hide Hotkey" LINK apppopup}
  3664.  @{"App-Icon" LINK App-icon}
  3665.  @{"AppIcon Configuration" LINK cfgAppIcon}
  3666.  @{"ARexx Configuration" LINK cfgARexx}
  3667.  @{"ARexx Macros" LINK F1}
  3668.  @{"ARexx Qualifier" LINK ARexxCycle}
  3669.  @{b}B@{ub}
  3670.  @{"Bar Scope Agent" LINK barscope}
  3671.  @{b}C@{ub}
  3672.  @{"Cancel Player/Noteplayer/Agent Configuration" LINK plcfgCancel}
  3673.  @{"Clear List, Players/Noteplayers/Agents" LINK plcfgClear}
  3674.  @{"CLI arguments.." LINK Tooltypes}
  3675.  @{"Config Hotkeys" LINK hotkeyconfiglist}
  3676.  @{"Config, Players/Noteplayers/Agents" LINK plcfgConfig}
  3677.  @{"Configuration - Save/Use/Cancel" LINK cfgsaveusecancel}
  3678.  @{"Configuration Menu" LINK prefsmenu}
  3679.  @{"Configuration Window" LINK cfg}
  3680.  @{"Contact addresses" LINK contact}
  3681.  @{"Copyright information and rules of distribution" LINK Disclaimer}
  3682.  @{"Cut Prefixes" LINK CutPrefixes}
  3683.  @{b}D@{ub}
  3684.  @{"Default Screen" LINK Defaultscreen}
  3685.  @{"Delete Item, Players/Noteplayers/Agents" LINK plcfgDelete}
  3686.  @{"Double Buffering" LINK DoubleBuffering}
  3687.  @{b}E@{ub}
  3688.  @{"Early Load" LINK EarlyLoad}
  3689.  @{"Eject module" LINK Eject}
  3690.  @{"End of modulelist"" LINK EndModulelist}
  3691.  @{"Error Messages" LINK ErrorMessages}
  3692.  @{"Exchange Items, Players/Noteplayers/Agents" LINK plcfgExchange}
  3693.  @{"Expunge Libraries" LINK ExpungeLibraries}
  3694.  @{"Extract Pattern" LINK extractpattern}
  3695.  @{b}F@{ub}
  3696.  @{"Fade At Pause/Next" LINK FadeatPause}
  3697.  @{"Fade Module At End" LINK FademoduleatEnd}
  3698.  @{"Fade Speed" LINK FadeSpeed}
  3699.  @{"Fast Forward" LINK FF}
  3700.  @{"Fastmem 4 Voices Configuration" LINK Fastcfg}
  3701.  @{"Favourite Song System Configuration" LINK FSS-Config}
  3702.  @{"Favourite Song System" LINK Fss}
  3703.  @{"File Requester" LINK DISK}
  3704.  @{"Force Filter Off" LINK ForceFilteroff}
  3705.  @{b}G@{ub}
  3706.  @{"General Font" LINK GeneralFont}
  3707.  @{b}H@{ub}
  3708.  @{"Hard'n'soft-ware requirements" LINK Requirements}
  3709.  @{"History of AccessiblePlayer" LINK History}
  3710.  @{"Hotkey Definition" LINK Hotkey}
  3711.  @{"Hotkey To Skip Module" LINK skiphotkey}
  3712.  @{"Hotkeys Configuration" LINK cfgHotkeys}
  3713.  @{"How to use AccessiblePlayer" LINK Usage}
  3714.  @{b}I@{ub}
  3715.  @{"Iconify AccessiblePlayer" LINK Icn}
  3716.  @{"IFF-8SVX Configuration" LINK iffcfg}
  3717.  @{"IFF-AIFF Configuration" LINK aiffcfg}
  3718.  @{"IFF-SMUS Configuration" LINK smuscfg}
  3719.  @{"Index" LINK INDEX}
  3720.  @{"Installing the AccessiblePlayer" LINK Installation}
  3721.  @{"Introduction to AccessiblePlayer" LINK Introduction}
  3722.  @{"Item Up/Down" LINK plcfgArrowupdown}
  3723.  @{b}J@{ub}
  3724.  @{"Jump To added Module" LINK Jumptoaddedmodule}
  3725.  @{b}K@{ub}
  3726.  @{"Keyboard control keys" LINK keyboard}
  3727.  @{b}L@{ub}
  3728.  @{"List Font" LINK Listfont}
  3729.  @{"List Selector" LINK plcyc}
  3730.  @{"ListView Control" LINK listview}
  3731.  @{"Load Libraries" LINK LoadLibraries}
  3732.  @{"Loop Active Module" LINK Loop}
  3733.  @{b}M@{ub}
  3734.  @{"Main window cycle" LINK Maincyc}
  3735.  @{"Main window list" LINK MainListview}
  3736.  @{"Main window list Scroller" LINK Scroll}
  3737.  @{"Module list Editor" LINK ML}
  3738.  @{"Module list" LINK modlist}
  3739.  @{"Module Path" LINK modulepath}
  3740.  @{"Module Types" LINK Modtypes}
  3741.  @{"ModulePattern" LINK Modulepattern}
  3742.  @{"Multi Sample Formats" LINK multimods}
  3743.  @{"Multi SampleSaver Configuration" LINK MultiSampleSaverConfig}
  3744.  @{b}N@{ub}
  3745.  @{"Never Ending Module Timeout Value" LINK timeoutvalue}
  3746.  @{"Never Ending Module Timeout" LINK Timeout}
  3747.  @{"Next module" LINK Next}
  3748.  @{"Noteplayer, 1st priority" LINK plcfgquestionmark}
  3749.  @{"NotePlayers" LINK NotePlayers}
  3750.  @{"Numeric Keypad" LINK Keypad}
  3751.  @{b}O@{ub}
  3752.  @{"Online Help" LINK OnlineHelp}
  3753.  @{"Optimize FSS List" LINK OptimizeFSS}
  3754.  @{"Options Configuration Page 1" LINK cfgOptions}
  3755.  @{"Options Configuration Page 2" LINK cfgoptions2}
  3756.  @{b}P@{ub}
  3757.  @{"Paths Configuration" LINK cfgPaths}
  3758.  @{"Pause module" LINK Pause}
  3759.  @{"Play" LINK Play}
  3760.  @{"Players" LINK players}
  3761.  @{"Players/Noteplayers/Agents Configuration" LINK cfgplayers}
  3762.  @{"Players/Noteplayers/Agents List" LINK plcfgplayerlist}
  3763.  @{"Popup/Hide Hotkey" LINK popuphide}
  3764.  @{"Previous Module" LINK Prev}
  3765.  @{b}R@{ub}
  3766.  @{"Rewind" LINK Rew}
  3767.  @{"RGB-Box Scope Agent" LINK RGB-box}
  3768.  @{"RIFF-WAVE Configuration" LINK riffcfg}
  3769.  @{b}S@{ub}
  3770.  @{"Sample info window" LINK SampleInfo}
  3771.  @{"SampleSaver - Multi" LINK Multi}
  3772.  @{"Save Player/Noteplayer/Agent Configuration" LINK plcfgSave}
  3773.  @{"Save Window Positions" LINK Savewindowpositions}
  3774.  @{"Screen List" LINK Screens}
  3775.  @{"Shareware Notice" LINK Shareware}
  3776.  @{"Show Hotkeys" LINK hotkeyshowlist}
  3777.  @{"Show, Players/Noteplayers/Agents" LINK plcfgShow}
  3778.  @{"Shuffle Modulelist" LINK Shuffle}
  3779.  @{"SID Configuration" LINK sidcfg}
  3780.  @{"Sort Items, Players/Noteplayers/Agents" LINK plcfgSort}
  3781.  @{"Sound Channels" LINK 1}
  3782.  @{"Speed Reset" LINK Sreset}
  3783.  @{"Spinning Squares Scope Agent" LINK SpinSquares}
  3784.  @{"Start Scan Path" LINK startscanpath}
  3785.  @{"Status bar" LINK Status}
  3786.  @{"Sub pages" LINK cfgPages}
  3787.  @{b}T@{ub}
  3788.  @{"Temp Path" LINK Temppath}
  3789.  @{"Thanks" LINK Thanks}
  3790.  @{"The Featurelist of AccessiblePlayer" LINK Features}
  3791.  @{"The Future of APlayer" LINK Future}
  3792.  @{"Tip of The Day" LINK Tipoftheday}
  3793.  @{"Tooltypes" LINK Tooltypes}
  3794.  @{"Tunes" LINK tunes}
  3795.  @{b}U@{ub}
  3796.  @{"Unpack Arguments" LINK Unpackarguments}
  3797.  @{"Unpack Check Pattern" LINK checkpattern}
  3798.  @{"Unpack Configuration" LINK cfgunpack}
  3799.  @{"Unpack Lha" LINK unpacklha}
  3800.  @{"Unpack Library" LINK unpacklibrary}
  3801.  @{"Unpack Lzx" LINK unpacklzx}
  3802.  @{"Unpack Path" LINK Unpackpath}
  3803.  @{"Update Lists" LINK Updatelists}
  3804.  @{"Use Player/Noteplayer/Agent Configuration" LINK plcfgUse}
  3805.  @{"Used Hotkeys" LINK usedhotkeyslist}
  3806.  @{b}V@{ub}
  3807.  @{"VBlank Interrupt" LINK VBlankInterrupt}
  3808.  @{"Version" LINK plcfgversion}
  3809.  @{"Volume Reset" LINK Volreset}
  3810.  @{b}W@{ub}
  3811.  @{"Why requesters" LINK why}
  3812.  @{"Windows/Screens Configuration" LINK cfgwindowsscreens}
  3813.  @{b}ARexx Links:@{ub}
  3814.  @{"ARexx" LINK ArexxMain}
  3815.  @{"Channels" LINK ARChannel}
  3816.  @{"Eject" LINK AReject}
  3817.  @{"LOOP" LINK ARLOOP}
  3818.  @{"MainCycle" LINK ARMAINCYCLE}
  3819.  @{"ModuleList" LINK ARMODULELIST}
  3820.  @{"Pause" LINK ARPAUSE}
  3821.  @{"Play" LINK ARPLAY}
  3822.  @{"Requester" LINK ARRequester}
  3823.  @{"Sample" LINK ARsample}
  3824.  @{"Speed" LINK ARSpeed}
  3825.  @{"Technical" LINK ARTechnical}
  3826.  @{"Various" LINK ARvarious}
  3827.  @{"Volume" LINK ARVolume}
  3828.  @{"Window" LINK ARWindow}
  3829. @ENDNODE
  3830. @NODE why
  3831. @TITLE "Why requesters"
  3832.   If you get an error requester  from  APlayer, and  you  don't  understand
  3833.   what's  going on, press the @{b}WHY@{ub} gadget in the requester. This gives you a
  3834.   brief description of the error, and suggestions on how to correct it.
  3835. @ENDNODE
  3836.